关键词

优傲机器人自然语言控制工业自动化LLM应用机器人控制

项目简介

nUR_MCP_SERVER 是由拓德科技开发的一款基于 Model Context Protocol (MCP) 的服务器应用。它作为连接大语言模型（LLM）与优傲（Universal Robots）协作机器人的中间件，使得用户可以通过自然语言指令直接控制机器人，革新了传统的机器人操作方式。

该服务器实现了 MCP 协议的核心功能，允许 LLM 客户端（如 Claude Desktop, Cherry Studio 等）访问机器人状态数据（作为资源）和执行机器人操作（作为工具）。

主要功能点

  • 自然语言控制： 直接通过语音或文本指令驱动优傲机器人进行运动（如移动到特定位置、沿着某个轴移动）和执行输入输出操作。
  • 智能数据采集： 实时获取机器人的各种硬件数据，包括关节角度、TCP（末端工具中心点）坐标、关节扭矩、电压、电流、温度等，并支持按自然语言规则过滤和生成报告。
  • 脚本生成与执行： 支持大语言模型理解复杂的指令，自动编写符合优傲机器人编程语言（URScript）的程序，并在机器人上执行。
  • 程序控制： 可以加载、运行、停止或暂停优傲机器人上已有的程序文件（.urp）。
  • 多机协同： 支持连接和控制多台优傲机器人，理论上可实现简单的协同任务或镜像运动。
  • 会话管理： 维护与 LLM 客户端的连接，确保通信稳定。
  • 能力声明： 向连接的 LLM 客户端声明其提供的工具和资源能力。

安装步骤

  1. 安装依赖环境： 确保您的系统已安装 Python 3.11 或更新版本、pip 25.1 或更新版本、UV Package Manager 0.6.14 或更新版本、bun 1.2.8 或更新版本。
  2. 下载项目代码： 打开终端或命令提示符，使用 Git 下载项目代码： 
    git clone https://gitee.com/nonead/nUR_MCP_SERVER.git
    或者从 GitHub 下载： 
    git clone https://github.com/nonead/nUR_MCP_SERVER.git
  3. 进入项目目录： 
    cd nUR_MCP_SERVER
  4. 安装项目所需库： 使用 pip 安装 'requirements.txt' 文件中列出的所有 Python 库： 
    pip install -r requirements.txt
    安装完成后，MCP 服务器端的基本环境就配置好了。

服务器配置（供MCP客户端调用）

要让您的 MCP 客户端（如 Claude Desktop, Cherry Studio, Cline 等支持 MCP 的应用）能够连接并使用 nUR_MCP_SERVER，您需要在客户端的配置文件中添加一项服务器配置。

通常，您需要指定以下信息：

  • 服务器 ID (或名称)： 给这个 MCP 服务器连接起一个唯一的标识符，例如 'nUR_MCP_SERVER'。
  • 启动命令 (command)： 执行服务器脚本的命令，通常是 'python'。
  • 启动参数 (args)： 传递给启动命令的参数列表，其中至少应包含服务器主程序脚本的完整路径，例如 '["/path/to/your/nUR_MCP_SERVER/main.py"]'。请将 '/path/to/your/nUR_MCP_SERVER' 替换为您实际下载项目代码的目录路径。

不同的 MCP 客户端有不同的配置方式和文件位置，请参考您使用的具体客户端的文档来添加这些配置。例如，对于某些客户端，您需要在 'mcpServers' 部分添加类似如下的条目：

{
  "nUR_MCP_SERVER": { // 这是您为服务器定义的ID
    "command": "python", // 启动命令
    "args": ["/home/user/path/to/nUR_MCP_SERVER/main.py"] // 服务器脚本路径，请根据您的实际情况修改
    // 可能还有其他可选配置项，如name, type, description, isActive等，具体取决于客户端
  }
}

请注意： 上面的 JSON 代码仅为示例，展示了客户端配置服务器时需要填写的关键信息。您需要按照您实际使用的MCP客户端的要求，在其对应的配置文件中填入这些信息，不要直接复制粘贴上面的代码块。将 '/home/user/path/to/nUR_MCP_SERVER/main.py' 替换为 'main.py' 文件在您系统上的实际绝对路径。

配置完成后，启动您的 MCP 客户端，它应该能够检测到并连接到 nUR_MCP_SERVER。

基本使用方法

连接成功后，您就可以在支持 MCP 的 LLM 客户端中通过自然语言与 nUR_MCP_SERVER 交互，控制优傲机器人。以下是一些您可以尝试的指令示例：

  • "连接优傲机器人IP: 192.168.1.199"
  • "获取当前连接的优傲机器人的TCP末端执行器位姿坐标"
  • "让机器人沿着Z轴向上移动20毫米"
  • "获取所有硬件数据，包括关节角度和电流"
  • "加载并执行名为 'my_robot_program.urp' 的程序"
  • "编写一个程序，让机器人画一个直径10厘米的圆，并执行"

请确保您的优傲机器人已连接到网络，并且 nUR_MCP_SERVER 运行所在的电脑可以访问到机器人。在使用过程中请务必遵守安全规范。

信息

分类

桌面与硬件

访问项目