matrix-mcp-server

概述

Matrix MCP Server 是一个全面的 TypeScript 实现，可安全地与 Matrix 家庭服务器功能进行交互。它提供了按层组织的只读和操作工具，允许客户端列出房间、检索消息、管理用户资料、创建和加入房间，并通过适当认证发送消息。该服务器支持 OAuth 2.0 和令牌交换用于生产部署，并提供开发模式进行测试。架构采用清晰的三层设计（HTTP、MCP 和 Matrix 层），确保安全的临时客户端管理和适当的权限检查。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• list-joined-rooms

  Get all rooms the user has joined

  试试:List all my rooms试试:Show me the rooms I'm part of
• get-room-inforoomId: string

  Get detailed information about a specific room

  试试:Get info for room !abc:example.com试试:Tell me about the general room
• get-room-messagesroomId: string, limit?: number

  Retrieve recent messages from a room

  试试:Get last 10 messages from #general试试:Show me recent messages in the team room
• get-user-profiletargetUserId: string

  Get profile information for any Matrix user

  试试:Get profile for @alice:example.com试试:Show me user details for Bob
• search-public-roomssearchTerm?: string, server?: string, limit?: number

  Discover public Matrix rooms to join

  试试:Find rooms about photography试试:Search for gaming rooms on matrix.org
• send-messageroomId: string, message: string, messageType?: 'text' | 'html' | 'emote', replyToEventId?: string

  Send messages to Matrix rooms

  试试:Hello world in #general试试:Send a formatted message to the team room
• create-roomroomName: string, isPrivate?: boolean, topic?: string, inviteUsers?: string[], roomAlias?: string

  Create new Matrix rooms with customizable settings

  试试:Create a private room for project planning试试:Make a public room called Photography Chat
• join-roomroomIdOrAlias: string

  Join Matrix rooms by ID or alias

  试试:Join room #general:example.com试试:I want to join the photography community
• leave-roomroomId: string, reason?: string

  Leave a Matrix room with optional reason

  试试:Leave room #general试试:Exit the spammy room please
• invite-userroomId: string, targetUserId: string

  Invite a user to a Matrix room

  试试:Invite @bob:example.com to our project room试试:Add Alice to the team room
• set-room-nameroomId: string, roomName: string

  Update the display name of a Matrix room

  试试:Rename room #general to General Discussion试试:Change room name to Project X
• set-room-topicroomId: string, topic: string

  Update the topic/description of a Matrix room

  试试:Set topic for #general to 'General discussions about anything'试试:Change room description to weekly meeting notes

可对比工具

安装

# 克隆仓库
git clone <repository-url>
cd matrix-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

# 配置环境
cp .env.example .env
# 编辑 .env 文件设置您的配置

# 启动服务器
npm start

{
  "mcpServers": {
    "matrix": {
      "command": "node",
      "args": ["dist/server.js"],
      "env": {
        "ENABLE_OAUTH": "true",
        "MATRIX_HOMESERVER_URL": "https://matrix.example.com"
      }
    }
  }
}

FAQ

此 MCP 服务器支持哪些认证方法？

该服务器支持 OAuth 2.0 和令牌交换用于生产部署，以及不使用 OAuth 的直接访问用于开发。建议在生产环境中使用 OAuth 模式，因为它可以防止直接暴露 Matrix 令牌。

如何处理多个 Matrix 家庭服务器？

该服务器支持通过环境变量进行多家庭服务器配置。您可以为每个家庭服务器配置不同的端点并设置适当的认证。

我可以将此 MCP 服务器与任何 Matrix 实现一起使用吗？

是的，该服务器旨在与任何 Matrix 家庭服务器实现一起使用，包括 Synapse、Dendrite 等。它使用标准的 Matrix 客户端-服务器 API 与家庭服务器通信。

matrix-mcp-server 对比