Mbotmcp

🚀 MBotMcp

該項目展示瞭如何藉助Spring AI和模型上下文協議（MCP）來控制mBot2機器人。通過此項目的設置，AI模型能夠運用簡單的自然語言命令（例如“探索”或“左轉”）對物理機器人進行控制，為機器人控制提供了更便捷、智能的方式。

🚀 快速開始

該項目旨在實現AI模型通過自然語言命令控制mBot2機器人，系統主要由實現模型上下文協議的Spring Boot應用程序、用於消息傳遞的MQTT代理、運行在mBot2機器人上的Python代碼以及AI客戶端集成功能構成。Spring應用程序將機器人控制命令公開為AI可調用函數，從而讓AI模型能以自然語言控制物理機器人。

✨ 主要特性

• 自然語言控制：AI模型可通過簡單自然語言命令控制mBot2機器人。
• 系統集成度高：涵蓋Spring Boot應用、MQTT代理、Python代碼及AI客戶端集成功能。
• 功能函數豐富：Spring應用程序將多種機器人控制命令作為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燈！

可用的機器人命令

BotService類定義了機器人可以理解的所有MCP工具：

• mbotExplore() - 執行'探索'例程
• mbotStop() - 停止機器人
• mbotBeep() - 使機器人發出蜂鳴聲
• mbotLeft() - 讓機器人左轉
• mbotRight() - 讓機器人右轉
• mbotForward() - 移動機器人向前
• mbotBackward() - 移動機器人向後

📚 詳細文檔

該項目展示瞭如何通過自然語言處理（NLP）使AI模型控制物理機器人，可以將此項目作為更復雜的機器人應用的起點。

📄 許可證

請參閱項目的許可證文件，以瞭解詳細許可信息。

⚠️ 重要提示

使用此項目時，請確保遵守所有安全和法律規範。作者不對因不當使用而導致的任何損害負責。