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

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