Attendee MCP

🚀 參會者MCP服務器

這是一個用於管理參會者會議機器人的模型上下文協議（MCP）服務器。通過Claude Desktop，你可以使用該服務器創建、管理會議機器人，並獲取會議記錄。

🚀 快速開始

本服務器需要運行中的參會者後端服務，請確保在使用此MCP服務器之前，已設置並啟動了參會者服務器。我們將以Claude為例進行說明，但你也可以使用任何與MCP兼容的工具。

克隆倉庫

# 克隆你的復刻倉庫或主倉庫
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. 使用Web MCP在網上查找答案。
2. 將結果傳遞給參會者機器人，由機器人將答案讀給我聽。

💻 使用示例

配置完成後，你可以在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. “網絡錯誤”或API連接問題：

   • 確保你的參會者服務器在配置的URL上運行。
   • 檢查你的API密鑰是否正確。
   • 驗證MEETING_BOT_API_URL和MEETING_BOT_API_KEY環境變量。

2. MCP服務器未在Claude Desktop中顯示：

   • 配置更改後，完全重啟Claude Desktop。
   • 檢查Claude Desktop配置文件的語法是否為有效的JSON。
   • 查看Claude Desktop日誌以獲取錯誤消息。

3. “方法不允許”錯誤：

   • 某些API端點可能在你的參會者服務器中未完全實現。
   • 查看你的參會者服務器日誌以獲取更多詳細信息。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。

🤝 貢獻指南

1. 復刻倉庫。
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服務器之前，已設置並啟動了參會者服務器。