Bracketbot Multi Robot Control

🚀 多ロボット制御MCPエージェント

このプロジェクトは、MCP（モデルコンテキストプロトコル）サーバーを作成し、AIエージェントが既存のFastAPIロボット制御サーバーを介して複数のロボットを同時に制御できるようにします。

🚀 クイックスタート

このプロジェクトでは、MCPサーバーを通じてAIエージェントが複数のロボットを同時に制御できます。以下に、必要な手順を説明します。

✨ 主な機能

• 複数のロボットを同時に制御
• ロボットの運動制御（前進、後退、左回転、右回転）
• ロボットのスピーカーから音を再生
• ロボットの状態情報を取得
• 精密な速度制御
• ロボットのカメラ画像にアクセス
• 統一APIでポート指定をサポート

📦 インストール

前提条件

• Python 3.10以上のバージョン
• UV（Pythonパッケージ管理ツール）
• 複数の稼働中のFastAPIロボット制御サーバー（例に示す通り）

インストール手順

1. Python 3.10環境がアクティブであることを確認します。
2. UVを使用して依存関係をインストールします。

   uv pip install -e .
   

💻 使用例

基本的な使用法

1. FastAPIロボット制御サーバーを起動します。

   • 最初のロボットは8000ポートで稼働
   • 他のロボットは8001、8002などのポートで順次稼働

2. 重要な更新：Claudeデスクトップクライアントは現在、自動的にMCPサーバーを実行します。

   • python server.pyで手動でサーバーを起動する必要はありません。
   • MCPサーバー機能はClaudeデスクトップクライアントに直接統合されています。

3. MCPサーバーにより、AIエージェントは複数のロボットを制御し、そのカメラにアクセスできます。

利用可能なツール

すべてのツールはportパラメーター（デフォルト：8000）を受け取り、制御するロボットを指定できます。

運動制御

• drive_forward：ロボットを前進させます。
• drive_backward：ロボットを後退させます。
• turn_left：ロボットを左に回転させます。
• turn_right：ロボットを右に回転させます。
• stop：ロボットの運動を停止させます。
• drive：精密な速度値を使用して制御します。

音声制御

• beep：ロボットのスピーカーから音を再生します。

カメラアクセス

• get_camera_image：ロボットのカメラ画像を取得します。

システム情報

• robot_status：ロボットの状態情報を取得します。
• list_available_robots：すべての利用可能なロボットとその状態をリストします。

利用可能なリソース

• robot://info/{port}：特定のポートのロボット機能の情報を取得します。