pyBittle MCP Server

pyBittle-mcp-server

Bluetooth経由でBittleロボットを制御するためのPython MCP（Model Context Protocol）サーバー。このサーバーは、MCPプロトコルを使用してBittleを移動、ポーズ、操作するための一連のコマンドを公開します。

特徴

• Bluetooth経由でBittleに接続
• 動きとポーズのコマンドを公開します (前進、後退、回転、座る、休むなど)
• リモートおよびプログラム制御用のMCPツールと統合
• すべてのアクティビティをbittle_mcp.logに記録します。

要件

• Python 3.10以上
• パッケージ管理のためのuv
• Bluetooth対応のBittleロボット
• pyBittleライブラリ
• mcp-serverライブラリ

インストールとセットアップ

1. uv をインストールします (高速で信頼性の高い Python パッケージ管理に推奨)。
   curl -Ls https://astral.sh/uv/install.sh | sh
2. 依存関係をインストールします:
   uv pip install -r requirements.txt # or, if using pyproject.toml: uv pip install -r pyproject.toml

使用法

1. Bluetooth を構成する: Bittle ロボットの電源がオンになっており、Bluetooth ペアリング モードになっていることを確認します。
2. MCP サーバーを実行します。
   uv pip run python server.py
   サーバーは Bittle に接続し、ステータスをbittle_mcp.logに記録しようとします。
3. MCP ツールとの統合:
   • このサーバーは、MCP プロトコルを介してコマンドを公開し、MCP 互換のクライアントまたはツールからアクセスできるようにします。
   • MCP CLIまたはその他の MCP ツールを使用して、Bittle ロボットで使用可能なコマンドを検出し、呼び出すことができます。
   • 例 (MCP CLI を使用):
     mcp call move_forward mcp call sit mcp call rest
   • 利用可能なすべてのコマンドは、 server.pyで@mcp.tool()で装飾され、MCP サーバーに自動的に登録されます。

発達

• メインロジックはserver.pyにあります。
• ログはコンソールとbittle_mcp.log両方に出力するように設定されています。
• コマンドは、MCP 公開のために@mcp.tool()で装飾されます。

トラブルシューティング

• サーバーが接続に失敗した場合は、Bluetooth ペアリングを確認し、他のプロセスが Bittle 接続を使用していないことを確認します。
• 詳細なエラー メッセージについては、 bittle_mcp.log確認してください。

ライセンス

MITライセンス