Mbotmcp

🚀 MBotMcp

このプロジェクトは、Spring AIとモデルコンテキストプロトコル（MCP）を使用してmBot2ロボットを制御する方法を示しています。この設定により、AIモデルは「探索」や「左に曲がる」などの簡単な自然言語コマンドで物理ロボットを制御できます。

https://github.com/user-attachments/assets/a11d68c5-dc52-4dab-9741-bc1cf47e2ec9

🚀 クイックスタート

このシステムを使用することで、AIモデルが自然言語コマンドを使って物理ロボットを制御できるようになります。以下に、システムの概要、必要な前提条件、設定手順、テスト方法などを説明します。

✨ 主な機能

システム構成

このシステムは以下の要素で構成されています。

1. モデルコンテキストプロトコルを実装したSpring Bootアプリケーション
2. メッセージング用のMQTTブローカー
3. mBot2ロボット上で動作するPythonコード
4. AIクライアント統合機能

Springアプリケーションは、ロボット制御コマンドをAIが呼び出せる関数として公開し、AIモデルが自然言語で物理ロボットを制御できるようにします。

ロボットコマンド

BotServiceクラスで定義されている、ロボットが理解できるMCPツールは以下の通りです。

• mbotExplore() - 「探索」ルーチンを実行
• mbotStop() - ロボットを停止
• mbotBeep() - ロボットをブザー音を鳴らす
• mbotLeft() - ロボットを左に曲がる
• mbotRight() - ロボットを右に曲がる
• mbotForward() - ロボットを前進
• mbotBackward() - ロボットを後退

AIモデルとの統合

このプロジェクトは、自然言語処理（NLP）を通じてAIモデルが物理ロボットを制御する方法を示しています。より複雑なロボットアプリケーションの起点として利用できます。

📦 インストール

前提条件

• Java 21
• Maven
• mBot2ロボットとmBlock IDE
• MQTTブローカー（Dockerで実行可能）
• Javaの基礎知識

設定手順

1. MQTTブローカーの設定（既存のブローカーがない場合のみ）

含まれるDocker Composeファイルを実行して、MQTTブローカーを設定します。

cd mbotmcp/assets
docker-compose up -d

このコマンドは、アプリケーションとロボット間でコマンドを中継するメッセージキューを作成します。

2. Spring Bootアプリケーションの設定

以下の環境変数を設定します。

MQTT_USERNAME=your_username # 設定されていない場合は空のままにする
MQTT_PASSWORD=your_password # 設定されていない場合は空のままにする
MQTT_SERVER_URI=tcp://your_server:1883

これらの変数は、アプリケーションがMQTTブローカーに接続する方法を指定します。

3. mBot2の設定

PythonスクリプトをmBot2にアップロードするには、以下の手順を実行します。

1. mBot2をUSBでコンピュータに接続します。
2. コンピュータ上でmBlock IDEを開きます。
3. 「ファイル」メニューをクリックし、「開く」を選択します。
4. リポジトリ内の/assetsディレクトリに移動します。
5. mbot-mqtt.pyファイルを開きます。
6. スクリプトを編集して、個人のWiFiとMQTT設定を含めます。

   ssid = "<your wifi ssid>"
   ssid_password = "<your wifi password>"
   mqtt_ip = "<ip of the mqtt broker>"
   mqtt_port = 1883
   mqtt_user = "<your mqtt username>"
   mqtt_password = "<your mqtt password>"
   

7. スクリプトをmBot2にアップロードします。
8. mBot2の電源をオンにします。

4. Spring Bootアプリケーションのビルド

mvn clean package

💻 使用例

基本的な使用法

設定が完了したら、以下の手順でシステムをテストできます。

1. MQTTブローカーが実行中であることを確認します。
2. mBot2の電源をオンにし、WiFiに接続していることを確認します。
3. テストクライアントを実行します。

   mvn test -Dtest=ClientStdioTest
   

4. ロボットが「ブザー音を鳴らす」コマンドを実行し、青色のLEDが点灯するのを確認します！

📄 ライセンス

詳細なライセンス情報については、プロジェクトのライセンスファイルを参照してください。

⚠️ 重要注意事項

このプロジェクトを使用する際は、すべての安全および法的規範を遵守するようにしてください。作者は、不適切な使用によって生じた損害について責任を負いません。