🚀 会议管理平台（MCP）集成指南

会议管理平台（MCP）集成指南为你提供了与不同工具整合的详细步骤、开发指南、日志管理方法、项目结构介绍、认证机制说明以及QR代码生成API密钥的配置方式，帮助你顺利使用和开发会议管理平台。

🚀 快速开始

与Claude桌面整合

1. 打开Claude桌面。
2. 进入设置。
3. 点击“模型上下文协议”。
4. 添加一个新的服务器，配置如下：
   • 名称：会议管理平台 MCP
   • 类型：sse（Server - Sent Events）
   • 服务器地址：http://localhost:7017/mcp
   • 若需要身份验证，可添加必要的请求头。

与Cursor整合

1. 打开Cursor。
2. 进入设置界面。
3. 导航至“模型上下文协议”选项。
4. 添加一个新的服务器配置：
   • 名称：会议管理平台 MCP
   • 类型：sse
   • 服务器地址：http://localhost:7017/mcp
   • 可选：添加身份验证所需的请求头。

📦 安装指南

构建项目

npm run build

测试与MCP检测工具

npm run inspect

开发模式（支持自动重启）

npm run dev

💻 使用示例

日志管理

服务器内置了优化的日志系统，可使用以下命令进行日志清理：

npm run cleanup

此命令执行以下操作：

• 清理不必要的日志文件和缓存数据。
• 过滤掉重复的心跳消息。
• 降低磁盘使用量，同时保留重要信息。
• 维持较小的日志 footprint，适合长期运行的服务器。

📚 详细文档

项目结构

• src/index.ts：程序入口点。
• src/tools/：工具实现文件。
• src/resources/：资源定义文件。
• src/api/：与会议管理平台后端通信的API客户端。
• src/types/：TypeScript类型定义。
• src/config.ts：服务器配置。
• src/utils/：
  • logging.ts：日志过滤和管理工具。
  • tinyDb.ts：用于持久化存储bot信息的数据库。

认证机制

服务器要求在x - api - key请求头中提供API密钥进行身份认证。默认情况下，你可以通过配置文件设置默认的API密钥。

此外，许多工具（命名规则为“WithCredentials”）支持直接传递API密钥作为参数，而不是放在请求头中。

QR代码生成API密钥配置

QR代码生成器工具需要使用QR Code AI API的API密钥，以下是几种提供方式：

1. 直接在提示中包含：在调用generateQRCode工具时，将API密钥直接写入提示文本，例如："为我的网站https://example.com生成QR代码，API密钥：qrc_your_key_here"
2. 作为参数传递：使用generateQRCode工具时，提供apiKey参数。
3. 环境变量：设置QRCODE_API_KEY环境变量。
4. Claude桌面配置：将API密钥添加到你的Claude桌面配置文件中：
   • Mac/Linux系统路径：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows系统路径：%APPDATA%\Claude\claude_desktop_config.json%

示例配置如下：

{
  "headers": {
    "x-api-key": "qrc_your_key_here"
  }
}

该工具将按上述顺序查找API密钥。如果未提供任何密钥，将使用可用的默认API密钥。获取API密钥请访问QR Code AI API注册账号。

📄 许可证

MIT