robot-mcp-server

robot-mcp-server

site icon
2025.02.27 8
Python机器人控制无人机控制其它
robot-mcp-server 是一个为大语言模型提供机器人控制能力的MCP服务器。它支持宇树机器人运动控制和大疆无人机起飞/降落控制,基于Model Context Protocol (MCP) 的标准接口,具备实时状态监控、紧急停止机制和完善的日志记录功能。
View on GitHub

Overview

基本能力

产品定位

robot-mcp-server 是一个为大语言模型提供机器人控制能力的MCP服务器。

核心功能

  • 支持宇树机器人运动控制
  • 支持大疆无人机起飞/降落控制
  • 基于Model Context Protocol (MCP) 的标准接口
  • 实时状态监控
  • 紧急停止机制
  • 完善的日志记录

适用场景

  • 机器人控制
  • 无人机控制
  • 大语言模型与机器人/无人机的交互

工具列表

宇树机器人工具

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

大疆无人机工具

  • dji_connect: 建立无人机连接
  • dji_takeoff(height: float): 起飞到指定高度
  • dji_land(): 安全降落

常见问题解答

使用教程

使用依赖

  • Python 3.10+
  • 宇树机器人SDK2 (自动安装)
  • 大疆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})

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。