Attendee MCP

🚀 与会者MCP服务器

这是一个用于管理与会者会议机器人的模型上下文协议（MCP）服务器。通过Claude Desktop，你可以使用该服务器创建、管理会议机器人，并获取会议记录。

🚀 快速开始

本MCP服务器需要运行中的与会者后端服务。在使用此MCP服务器之前，请确保你已设置并运行了与会者服务器。

示例：使用Claude

我们以Claude为例，但你可以使用任何支持MCP的工具。

克隆仓库

# 克隆你的fork仓库或主仓库
git clone https://github.com/rexposadas/attendee-mcp.git
cd attendee-mcp

# 安装依赖
npm install

# 构建TypeScript
npm run build

# 全局链接
npm link

配置环境变量

为你的与会者服务器设置以下环境变量：

export MEETING_BOT_API_URL="http://localhost:8000"  # 你的与会者服务器URL
export MEETING_BOT_API_KEY="your-api-key-here"     # 你的与会者API密钥

将这些变量添加到你的shell配置文件（如~/.zshrc、~/.bashrc等）中，使其永久生效。

配置Claude Desktop

更新Claude Desktop的配置文件，路径为：~/Library/Application Support/Claude/claude_desktop_config.json。修改完成后，重启Claude。

调整mcpServers部分，以包含与会者MCP服务器。目前建议使用直接路径，因为这种方式最可靠。

{
  "mcpServers": {
    "attendee": {
      "command": "node",
      "args": [
        "<path>/attendee-mcp/dist/index.js"
      ],
      "env": {
        "MEETING_BOT_API_URL": "<attendee-url-here>",
        "MEETING_BOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

将/path/to/attendee-mcp替换为你克隆仓库的实际路径。

本地运行与会者服务器

1. 启动与会者服务器：

   make build
   make up
   

2. 在Claude Desktop中测试： 向Claude提问："有哪些可用的MCP工具？"

✨ 主要特性

此MCP的功能

1. 你可以使用“Send a bot to this meeting: <meeting_url>”将机器人发送到会议。
2. 你可以使用“Have the bot say ”让机器人在会议中发言。
3. 你可以使用“Have the bot send a chat message: ”让机器人发送聊天消息。
4. 你可以使用“Have the bot leave the meeting”让机器人离开会议。

使用此MCP通过Claude能做的事

基本机器人管理

1. "Send a bot to this meeting: <meeting_url>" - 创建并发送一个与会者机器人加入任何会议（Zoom、Google Meet、Teams）。
2. "Get me the status of bot <bot_id>" - 返回当前状态、状态信息和转录进度。
3. "List all my active bots" - 显示所有当前活跃的会议机器人。
4. "Remove bot <bot_id> from the meeting" - 让机器人离开会议。

高级机器人功能

5. "Make bot <bot_id> say 'Hello everyone!'" - 文本转语音功能。
6. "Send chat message 'Hi there!' from bot <bot_id>" - 通过机器人发送聊天消息。
7. "Show this image in the meeting: <image_url> using bot <bot_id>" - 显示图片（仅适用于Google Meet）。
8. "Play this video in the meeting: <video_url> using bot <bot_id>" - 播放MP4视频（仅适用于Google Meet）。

数据访问

9. "Get the transcript from bot <bot_id>" - 检索会议记录。
10. "Get chat messages from bot <bot_id>" - 检索会议中的所有聊天消息。
11. "Get the recording from bot <bot_id>" - 获取会议录音的下载URL。
12. "Delete all data for bot <bot_id>" - 永久删除录音、记录等所有数据。

组合MCP

组合MCP可以实现强大的工作流程。例如，我同时使用Brave Search MCP和与会者MCP。当我向Claude提问“谁赢得了上一届法国网球公开赛？”时，它会：

1. 使用网络MCP在网上查找答案。
2. 将结果传递给与会者机器人，由机器人将答案读给我听。

📦 安装指南

克隆仓库

# 克隆你的fork仓库或主仓库
git clone https://github.com/rexposadas/attendee-mcp.git
cd attendee-mcp

# 安装依赖
npm install

# 构建TypeScript
npm run build

# 全局链接
npm link

💻 使用示例

配置完成后，你可以在Claude Desktop中使用自然语言命令：

创建会议机器人

• "Create a meeting bot for this Zoom: https://zoom.us/j/123456789"
• "Send a bot to this Google Meet: https://meet.google.com/abc-defg-hij"
• "Join this Teams meeting with a bot: https://teams.microsoft.com/..."

管理机器人

• "What's the status of bot bot_abc123?"
• "Show me all my active bots"
• "List all meeting bots"
• "Remove bot bot_abc123 from the meeting"

🔧 技术细节

可用的MCP工具

此服务器提供以下工具：

核心机器人管理

• create_meeting_bot - 创建一个机器人加入并记录会议。
• get_bot_status - 检查会议机器人的当前状态。
• list_meeting_bots - 列出所有活跃的会议机器人。
• remove_meeting_bot - 从会议中移除一个机器人。

通信与媒体

• make_bot_speak - 让机器人使用文本转语音功能发言。
• send_chat_message - 通过机器人发送聊天消息。
• send_image_to_meeting - 通过机器人显示图片（仅适用于Google Meet）。
• send_video_to_meeting - 通过机器人播放视频（仅适用于Google Meet）。

数据检索

• get_meeting_transcript - 检索会议记录。
• get_chat_messages - 获取会议中的聊天消息。
• get_recording - 获取录音下载URL。
• delete_bot_data - 永久删除所有机器人数据。

🐛 故障排除

常见问题

1. "Network error"或API连接问题：

   • 确保你的与会者服务器在配置的URL上运行。
   • 检查你的API密钥是否正确。
   • 验证MEETING_BOT_API_URL和MEETING_BOT_API_KEY环境变量。

2. MCP服务器未在Claude Desktop中显示：

   • 配置更改后，完全重启Claude Desktop。
   • 检查Claude Desktop配置文件的语法是否为有效的JSON。
   • 查看Claude Desktop日志以获取错误消息。

3. "Method not allowed"错误：

   • 某些API端点可能在你的与会者服务器中未完全实现。
   • 查看你的与会者服务器日志以获取更多详细信息。

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。

🤝 贡献指南

1. Fork此仓库。
2. 创建一个功能分支：git checkout -b feature-name。
3. 进行更改并测试。
4. 提交更改：git commit -m 'Add feature'。
5. 推送到分支：git push origin feature-name。
6. 提交拉取请求。

🔗 相关项目

• Attendee - 主要的会议机器人服务。
• Model Context Protocol - MCP规范和SDK。

⚠️ 重要提示

此MCP服务器需要运行中的与会者后端服务。在使用此MCP服务器之前，请确保你已设置并运行了与会者服务器。