概述

matrix-mcp 是一个用 TypeScript 实现的 MCP 服务器，提供了与 Matrix 家域服交互的工具。它包括连接到 Matrix 服务器、列出已加入的房间、获取房间消息等功能。

先决条件

• Node.js 20 或更高版本
• npm（Node 包管理器）

设置说明

1. 克隆仓库

   git clone <repository-url>
   cd matrix-mcp-server
   

2. 安装依赖项

   npm install
   

3. 运行服务器

   以开发模式启动 MCP 服务器：

   npm run dev
   

   要构建并在生产模式下运行服务器：

   npm run build
   npm start
   

   默认情况下，服务器将在 http://localhost:3000 上运行。

测试服务器

可以使用 Postman 或 curl 等工具测试服务器。例如，要连接到 Matrix 家域服，向 /connect-matrix 发送 POST 请求，携带以下 JSON 有效负载：

{
  "homeserverUrl": "https://matrix.org",
  "username": "your-username",
  "password": "your-password"
}

添加到 VSCode

将以下内容添加到 VSCode 的配置文件中：

{
  "servers": {
    "matrix-mcp": {
      "type": "stdio",
      "command": "<full-path-to>/node",
      "args": [
        "<full-path-to>/matrix-mcp-server/dist/server.js"
      ]
    }
  }
}

注意事项

• 此项目用于开发目的。在生产环境中使用时，请确保实施适当的安全措施和会话管理。
• 参考 src/server.ts 文件以获取更多配置选项。

许可证

此项目根据 MIT 许可证发布。