Scan to contactarticle
README
🚀 与会者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替换为你克隆仓库的实际路径。
本地运行与会者服务器
- 启动与会者服务器：
make build make up - 在Claude Desktop中测试： 向Claude提问："有哪些可用的MCP工具？"
✨ 主要特性
此MCP的功能
- 你可以使用“Send a bot to this meeting: <meeting_url>”将机器人发送到会议。
- 你可以使用“Have the bot say ”让机器人在会议中发言。
- 你可以使用“Have the bot send a chat message: ”让机器人发送聊天消息。
- 你可以使用“Have the bot leave the meeting”让机器人离开会议。
使用此MCP通过Claude能做的事
基本机器人管理
- "Send a bot to this meeting:
<meeting_url>" - 创建并发送一个与会者机器人加入任何会议（Zoom、Google Meet、Teams）。 - "Get me the status of bot
<bot_id>" - 返回当前状态、状态信息和转录进度。 - "List all my active bots" - 显示所有当前活跃的会议机器人。
- "Remove bot
<bot_id>from the meeting" - 让机器人离开会议。
高级机器人功能
- "Make bot
<bot_id>say 'Hello everyone!'" - 文本转语音功能。 - "Send chat message 'Hi there!' from bot
<bot_id>" - 通过机器人发送聊天消息。 - "Show this image in the meeting:
<image_url>using bot<bot_id>" - 显示图片（仅适用于Google Meet）。 - "Play this video in the meeting:
<video_url>using bot<bot_id>" - 播放MP4视频（仅适用于Google Meet）。
数据访问
- "Get the transcript from bot
<bot_id>" - 检索会议记录。 - "Get chat messages from bot
<bot_id>" - 检索会议中的所有聊天消息。 - "Get the recording from bot
<bot_id>" - 获取会议录音的下载URL。 - "Delete all data for bot
<bot_id>" - 永久删除录音、记录等所有数据。
组合MCP
组合MCP可以实现强大的工作流程。例如，我同时使用Brave Search MCP和与会者MCP。当我向Claude提问“谁赢得了上一届法国网球公开赛？”时，它会：
- 使用网络MCP在网上查找答案。
- 将结果传递给与会者机器人，由机器人将答案读给我听。
📦 安装指南
克隆仓库
# 克隆你的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- 永久删除所有机器人数据。
🐛 故障排除
常见问题
-
"Network error"或API连接问题：
- 确保你的与会者服务器在配置的URL上运行。
- 检查你的API密钥是否正确。
- 验证
MEETING_BOT_API_URL和MEETING_BOT_API_KEY环境变量。
-
MCP服务器未在Claude Desktop中显示：
- 配置更改后，完全重启Claude Desktop。
- 检查Claude Desktop配置文件的语法是否为有效的JSON。
- 查看Claude Desktop日志以获取错误消息。
-
"Method not allowed"错误：
- 某些API端点可能在你的与会者服务器中未完全实现。
- 查看你的与会者服务器日志以获取更多详细信息。
📄 许可证
本项目采用MIT许可证，详情请参阅LICENSE文件。
🤝 贡献指南
- Fork此仓库。
- 创建一个功能分支：
git checkout -b feature-name。 - 进行更改并测试。
- 提交更改：
git commit -m 'Add feature'。 - 推送到分支：
git push origin feature-name。 - 提交拉取请求。
🔗 相关项目
- Attendee - 主要的会议机器人服务。
- Model Context Protocol - MCP规范和SDK。
⚠️ 重要提示
此MCP服务器需要运行中的与会者后端服务。在使用此MCP服务器之前，请确保你已设置并运行了与会者服务器。