Bracketbot Multi Robot Control

🚀 多機器人控制 MCP 代理

本項目搭建了一個 MCP（模型上下文協議）服務器，藉助現有的 FastAPI 機器人控制服務器，讓 AI 代理能夠同時操控多個機器人，極大提升了機器人控制的效率和靈活性。

🚀 快速開始

多機器人控制 MCP 代理可讓你輕鬆實現多個機器人的協同控制。首先要確保滿足先決條件，然後按照安裝步驟完成安裝，最後依據使用方法開啟多機器人控制之旅。

✨ 主要特性

• 🌐 同時控制多個機器人，實現集群化操作。
• 🚗 精準控制機器人運動，支持前進、後退、左轉、右轉等動作。
• 🔊 通過機器人揚聲器播放聲音，實現信息交互。
• 📊 獲取機器人狀態信息，即時掌握機器人運行情況。
• ⚙️ 精確速度控制，滿足不同場景需求。
• 📷 訪問機器人攝像頭圖像，獲取視覺信息。
• 🛠️ 統一 API，支持端口指定，方便靈活配置。

📦 安裝指南

先決條件

• Python 3.10+版本
• UV（Python 包管理工具）
• 多個運行中的 FastAPI 機器人控制服務器（如示例中所示）

安裝步驟

1. 確保已激活 Python 3.10 環境。
2. 使用 UV 安裝依賴項：

uv pip install -e .

💻 使用示例

基礎用法

啟動 FastAPI 機器人控制服務器

• 第一個機器人運行在 8000 端口。
• 其他機器人依次運行在 8001、8002 等端口。

重要提示

⚠️ 重要更新

Claude 桌面客戶端現在自動為您運行 MCP 服務器，無需手動通過python server.py啟動服務器，MCP 服務器功能已直接集成到 Claude 桌面客戶端中。

MCP 服務器使用

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}：獲取特定端口機器人功能的信息。