MCP.so
登录

Matrix MCP Server

@mjknowles

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

mjknowles

关于 Matrix MCP Server

用于集成 Matrix 主服务器的 MCP 服务器,支持聊天、管理房间等功能。

Matrix MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "matrix-mcp-server": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Matrix MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

什么是 matrix-mcp-server?

一个功能全面的 Model Context Protocol(MCP)服务器,可安全地访问 Matrix 主服务器的各项功能。它基于 TypeScript 构建,让 MCP 客户端能够通过标准化接口与 Matrix 的房间、消息、用户等进行交互。

如何使用 matrix-mcp-server?

通过 npm 安装依赖,构建项目,在 .env 文件中配置环境变量,然后使用 npm start 启动服务器。客户端通过 HTTP 传输连接,并在请求头中提供 Matrix 用户 ID、主服务器 URL 和访问令牌(或使用 OAuth)。服务器提供两种认证模式:用于生产环境的 OAuth 模式和用于测试的开发模式。

matrix-mcp-server 的主要功能

  • 支持令牌交换的 OAuth 2.0 认证
  • 按功能层级组织的 15 个 Matrix 工具
  • 支持多个主服务器,端点可配置
  • 通过临时客户端管理实现实时操作
  • 完善的错误处理和输入校验
  • 返回包含详细 Matrix 数据的丰富响应

matrix-mcp-server 的使用场景

  • 列出用户已加入的房间并获取房间详情
  • 发送消息和私信,管理房间成员
  • 搜索公开房间,并按日期范围筛选消息
  • 按消息数量找出房间中最活跃的用户
  • 创建、加入、离开和管理 Matrix 房间

常见问题

1

什么是 OAuth 模式?什么时候应该使用它?

OAuth 模式与你的身份提供商进行完整的 OAuth 2.0 集成,支持通过令牌交换完成 Matrix 主服务器认证,推荐在生产部署中使用。

2

运行环境有哪些要求?

需要 Node.js 20+ 和 npm、可访问的 Matrix 主服务器(Synapse、Dendrite 等),以及 Claude Desktop 或安装了 MCP 扩展的 VS Code 等 MCP 客户端。

3

用户和房间数据存放在哪里?

所有数据都存放在 Matrix 主服务器上。服务器会创建临时的 Matrix 客户端,由它们完成认证、执行操作并自动清理;不会在本地存储任何数据。

4

权限和安全如何处理?

所有 Matrix 客户端都是临时的,OAuth 避免了令牌的直接暴露,房间的权限等级和权限设置都会得到遵守,输入校验使用 Zod schema。CORS 也可以配置。

5

可以不使用 OAuth 来运行 matrix-mcp-server 吗?

可以。在开发模式(ENABLE_OAUTH=false)下,你可以直接使用 Matrix 访问令牌,但不建议在生产环境中这样做。

评论

其他 分类下的更多 MCP 服务器