universal-robot-mcp by RoversX - MCP Server

Universal Robot MCP Server

A Model Context Protocol (MCP) server that provides AI assistants and LLM applications with secure, controlled access to Universal Robots functionality. This server enables real-time robot control, status monitoring, and motion planning through a standardized MCP interface.

Features

Robot Connection Management - Connect/disconnect from UR robots safely
Real-time Status Monitoring - Get joint positions, poses, and robot health
Joint Motion Control - Precise angular movement with safety limits
Linear Motion Control - Cartesian path planning and execution
Simulation Mode - Test and develop without physical hardware
Safety First - Built-in collision detection and movement validation

Installation

Quick Start with uvx (Recommended)

uvx universal-robot-mcp

Install via pip

pip install universal-robot-mcp

Development Installation

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

Usage

AI Assistant Integration

Claude Desktop

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

Cursor / Other MCP Clients

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

VS Code with MCP

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

Direct Usage

# Run the server directly
python -m universal_robot_mcp.server

# Or use the installed script
universal-robot-mcp

Available Tools

Tool	Description	Parameters
`connect_robot`	Establish connection to UR robot	`robot_ip` (default: 192.168.1.100)
`disconnect_robot`	Safely disconnect from robot	None
`get_robot_status`	Get current joint positions and pose	None
`move_robot_joints`	Move to specific joint angles	`joint1-6`, `acceleration`, `velocity`
`move_robot_linear`	Linear movement in Cartesian space	`x,y,z,rx,ry,rz`, `acceleration`, `velocity`

Example Conversations

Once configured with your AI assistant:

"Connect to the robot and show me its current status"
"Move the robot to home position safely"
"Execute a pick and place motion from coordinates X to Y"
"What are the current joint angles?"
"Move the robot 10cm up in the Z direction"

Robot Configuration

Network Setup

Default robot IP: 192.168.1.100
Ensure robot is connected to your network
Verify robot is in Remote Control mode

Safety Features

Automatic TCP and payload configuration
Movement speed and acceleration limits
Connection timeout handling
Emergency stop capabilities

Supported Platforms

AI Assistants: Claude Desktop, Cursor, Roo Code, Cline
IDEs: VS Code, JetBrains IDEs (with MCP plugins)
Platforms: macOS, Linux, Windows
Python: 3.8, 3.9, 3.10, 3.11

License

GPL-3.0

My blog

CloseX Blog