Attendee MCP

🚀 参加者MCPサーバー

参加者会議ボットを管理するためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、Claude Desktopを通じて会議ボットを作成、管理し、会議の文字起こしを取得することができます。

🚀 クイックスタート

このMCPサーバーを使用する前に、実行中の参加者バックエンドサービスが必要です。この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」と入力することで、ボットを会議から退出させることができます。

今後の予定

• [x] ボットが会議に参加する
• [x] ボットが会議から退出する
• [x] ボットの状態を取得する
• [x] 音声メッセージを送信する（ボットを通じて音声を送信する）
• [x] チャットメッセージを送信する
• [ ] アクティブなボットのリストを取得する

この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を併用します。「Who won the last Roland Garros tournament?」とClaudeに尋ねると、以下のように動作します。

1. Web MCPを使用してオンラインで答えを検索します。
2. 結果を参加者ボットに渡し、ボットが答えを音声で返します。

📦 インストール

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キー

これらをシェルプロファイル（~/.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に「What MCP tools are available?」と尋ねます。

💻 使用例

設定が完了したら、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. リポジトリをフォークします。
2. 機能ブランチを作成します：git checkout -b feature-name
3. 変更を加えてテストします。
4. 変更をコミットします：git commit -m 'Add feature'
5. ブランチにプッシュします：git push origin feature-name
6. プルリクエストを送信します。

🔗 関連プロジェクト

• 参加者 - 主な会議ボットサービス
• モデルコンテキストプロトコル - MCPの仕様とSDK

⚠️ 重要提示

このMCPサーバーには、実行中の参加者バックエンドサービスが必要です。このMCPサーバーを使用する前に、参加者サーバーをセットアップして実行してください。