Meeting Bot Mcp Server

Attendee MCP 服务

这是一个用于通过 Attendee 发送和管理会议机器人 MCP。Attendee 是一款用于录制和转录的开源会议机器人。你可以在本地运行 Attendee，也可以将其部署到云端。

有问题？加入 Attendee Slack。

快速开始：这个 MCP 能做什么？

以 Claude 为例：你可以输入以下内容，开始使用 AI 会议机器人。

1. “派一个机器人加入这场会议：<meeting_url>”
2. “让机器人说‘Hello’”，机器人就会在会议中说“Hello”。
3. “让机器人发送一条聊天消息：‘Glad to be here’”，机器人就会在聊天中发送“Glad to be here”。
4. “让机器人离开会议”

组合使用 MCP

组合使用 MCP 可以构建强大的工作流。例如，我会同时使用 Brave Search MCP 和 Attendee MCP。当我问 Claude：“上一届法国网球公开赛的冠军是谁？”时，它会：

1. 使用 Web MCP 在线查找答案。
2. 将结果传给 Attendee 机器人，由它把答案说给我听。

🚀 安装

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

克隆仓库

# Clone your fork or the main repo
git clone https://github.com/rexposadas/attendee-mcp.git
cd attendee-mcp

# Install dependencies
npm install

# Build the TypeScript
npm run build

# Link for global use
npm link

⚙️ 配置

环境变量

为你的 Attendee 服务设置以下环境变量：

export MEETING_BOT_API_URL="http://localhost:8000"  # Your Attendee server URL
export MEETING_BOT_API_KEY="your-api-key-here"     # Your Attendee API key

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

Claude Desktop 配置

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

调整 mcpServers 部分以包含 Attendee 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 替换为你克隆仓库的实际路径。

🏃‍♂️ 本地运行 Attendee 的快速开始

1. 启动 Attendee 服务：

   make build
   make up
   

2. 在 Claude Desktop 中测试：
   • 询问 Claude：“有哪些 MCP 工具可用？”

🎯 使用示例

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

创建会议机器人

• “为这场 Zoom 会议创建一个机器人：https://zoom.us/j/123456789”
• “派一个机器人加入这场 Google Meet 会议：https://meet.google.com/abc-defg-hij”
• “派一个机器人加入这场 Teams 会议：https://teams.microsoft.com/...”

管理机器人

• “机器人 bot_abc123 的状态是什么？”
• “将机器人 bot_abc123 移出会议”

🔧 可用的 MCP 工具

此服务提供以下工具：

核心机器人管理

• create_meeting_bot - 创建一个加入并录制会议的机器人
• get_bot_status - 检查会议机器人的当前状态
• 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. “网络错误”或 API 连接问题：

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

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

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

3. “不允许使用该方法”错误：

   • Attendee 服务中的某些 API 端点可能尚未完全实现
   • 查看 Attendee 服务日志，了解更多详情

📄 许可证

MIT 许可证——详情请参阅 LICENSE 文件。

🤝 贡献

1. Fork 此仓库
2. 创建功能分支：git checkout -b feature-name
3. 修改代码并进行测试
4. 提交更改：git commit -m 'Add feature'
5. 将更改推送到分支：git push origin feature-name
6. 提交 pull request

🔗 相关项目

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

---

**注意：**此 MCP 服务需要正在运行的 Attendee 后端服务。使用此 MCP 服务前，请确保已设置并启动 Attendee 服务。