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