pyBittle-mcp-server

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

特徴

• Bluetooth経由でBittleに接続

• 動きとポーズのコマンドを公開します (前進、後退、回転、座る、休むなど)

• リモートおよびプログラム制御用のMCPツールと統合

• すべてのアクティビティをbittle_mcp.logに記録します。

Related MCP server: Unitree Go2 MCP Server

要件

• 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ライセンス