robot-mcp-server

提供大型语言模型机器人控制能力的MCP服务器

功能

• ✅ 支持宇树机器人运动控制
• ✅ 支持DJI无人机起飞/降落控制
• ✅ 基于模型上下文协议（MCP）的标准接口
• 📡 实时状态监控
• 🛑 紧急停止机制
• 📊 完整日志记录

安装指南

预备条件

• Python 3.10+
• Yushu Robot SDK2（自动安装）
• DJI Tello无人机SDK（自动安装）

# 创建并激活虚拟环境
python -m venv .venv
.venv\Scripts\activate

# 安装依赖
pip install git+https://github.com/unitreerobotics/unitree_sdk2_python.git
pip install djitellopy

快速开始

from modelcontextprotocol import Client

# 连接到MCP服务
client = Client.connect_stdio()

# 控制宇树机器人
client.call_tool("unitree_connect", {})
client.call_tool("unitree_move", {"velocity": 1.5})

# 控制DJI无人机
client.call_tool("dji_connect", {})
client.call_tool("dji_takeoff", {"height": 2.0})

API文档

宇树机器人工具

• unitree_connect：建立机器人连接
• unitree_move(velocity: float, duration: float)：控制移动
• unitree_stop()：紧急停止

DJI无人机工具

• dji_connect：建立无人机连接
• dji_takeoff(height: float)：飞至指定高度
• dji_land()：安全着陆

开发指南

项目结构：

├── src/
│   ├── main.py          # 主服务入口
│   ├── unitree_adapter.py # 宇树机器人适配器
│   └── dji_adapter.py   # DJI无人机适配器
├── examples/            # 使用示例
├── requirements.txt     # 依赖列表
└── README.md            # 项目文档

贡献

欢迎提交Issue和PR，请遵循现有的代码风格并添加适当的测试。

许可证协议

MIT 许可证