Universal Robot

MCP server for Universal Robots control

python

3

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

The Universal Robot MCP Server lets you securely access and control Universal Robots robots through a standardized MCP interface. You can connect to robots, monitor status in real time, and perform precise joint or Cartesian motions while benefiting from safety checks and optional simulation. This enables AI assistants and tools to orchestrate robot tasks with clear, safe commands.

How to use

You will connect your MCP clients to the server to perform common robot operations. Start by choosing a connection method supported by the server. The easiest option is to use the MCP runner that integrates with clients like AI assistants and code editors. After starting the server, you can issue commands to connect to a UR robot, query its status, and issue movement commands. Use the intuitive actions below to accomplish real-time control, status monitoring, and motion planning while respecting safety limits.

How to install

Prerequisites: you need Python and a package manager to install and run the MCP server.

# Quick start using the MCP runner
uvx universal-robot-mcp

# Install the MCP package for development or reuse
pip install universal-robot-mcp

# For development work (optional)
git clone https://github.com/RoversX/universal-robot-mcp
cd universal-robot-mcp
pip install -e .

Additional sections

Robot configuration and safety are integral parts of the MCP Server experience. The server provides automatic TCP and payload configuration, movement speed and acceleration limits, and emergency stop capabilities to help you avoid unsafe robot actions. When you enable simulation mode, you can test motions and logic without connecting to physical hardware.

Direct usage tips

Run the server directly to start serving MCP requests. You can also use the installed script for convenience.

# Run the server directly
python -m universal_robot_mcp.server

# Or use the installed script
universal-robot-mcp

Available tools

connect_robot

Establish a connection to a UR robot using the MCP interface, enabling subsequent status queries and motion commands.

disconnect_robot

Safely disconnect from the connected UR robot, ensuring the current trajectory and payload are properly handled.

get_robot_status

Retrieve current joint positions, Cartesian pose, and overall robot health information.

move_robot_joints

Move the robot to specified joint angles with safety limits and defined acceleration/velocity profiles.

move_robot_linear

Execute linear motion in Cartesian space with defined target pose and motion parameters.