Universal Robot MCP Server

提供AI助手和LLM应用程序安全、受控访问Universal Robots功能的模型上下文协议（MCP）服务器。此服务器通过标准化的MCP接口实现实时机器人控制、状态监控和运动规划。

功能

• 机器人连接管理 - 安全地连接/断开UR机器人
• 实时状态监控 - 获取关节位置、姿态和机器人健康状况
• 关节运动控制 - 具有安全限制的精确角度运动
• 线性运动控制 - 笛卡尔路径规划与执行
• 模拟模式 - 在没有物理硬件的情况下进行测试和开发
• 安全第一 - 内置碰撞检测和运动验证

安装

快速启动（推荐）

uvx universal-robot-mcp

通过pip安装

pip install universal-robot-mcp

开发安装

git clone https://github.com/RoversX/universal-robot-mcp
cd universal-robot-mcp
pip install -e .

使用

AI助手集成

Claude Desktop

{
  "mcpServers": {
    "universal-robot": {
      "command": "uvx",
      "args": ["universal-robot-mcp"]
    }
  }
}

Cursor / 其他MCP客户端

{
  "mcpServers": {
    "universal-robot": {
      "command": "universal-robot-mcp"
    }
  }
}

VS Code与MCP

{
  "mcp.servers": {
    "universal-robot": "uvx universal-robot-mcp"
  }
}

直接使用

# 直接运行服务器
python -m universal_robot_mcp.server

# 或使用已安装的脚本
universal-robot-mcp

可用工具

工具	描述	参数
connect_robot	建立与UR机器人的连接	robot_ip（默认：192.168.1.100）
disconnect_robot	安全断开与机器人的连接	无
get_robot_status	获取当前关节位置和姿态	无
move_robot_joints	移动到特定关节角度	joint1-6，acceleration，velocity
move_robot_linear	笛卡尔空间中的线性运动	x,y,z,rx,ry,rz，acceleration，velocity

示例对话

配置好您的AI助手后：

• "连接到机器人并显示其当前状态"
• "安全地移动机器人到起始位置"
• "从坐标X到Y执行拾取和放置动作"
• "当前关节角度是多少？"
• "在Z方向上向上移动机器人10厘米"

机器人配置

网络设置

• 默认机器人IP：192.168.1.100
• 确保机器人连接到您的网络
• 验证机器人处于远程控制模式

安全特性

• 自动TCP和负载配置
• 运动速度和加速度限制
• 连接超时处理
• 紧急停止功能

支持平台

• AI助手：Claude Desktop，Cursor，Roo Code，Cline
• IDE：VS Code，JetBrains IDEs（带有MCP插件）
• 平台：macOS，Linux，Windows
• Python：3.8，3.9，3.10，3.11

许可证

GPL-3.0

我的博客

CloseX Blog