ROS MCP Server

Install

npx skillfoxx add mcp/ros-mcp-server

claude mcp add --transport stdio ros-mcp-server -- uvx ros-mcp==3.1.2

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

code --add-mcp '{"name":"ros-mcp-server","type":"stdio","command":"uvx","args":["ros-mcp==3.1.2"]}'

{
  "servers": {
    "ros-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

codex mcp add ros-mcp-server -- uvx ros-mcp==3.1.2

[mcp_servers.ros-mcp-server]
command = "uvx"
args = ["ros-mcp==3.1.2"]

gemini mcp add -s user ros-mcp-server uvx ros-mcp==3.1.2

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcp": {
    "ros-mcp-server": {
      "type": "local",
      "command": [
        "uvx",
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "context_servers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

{
  "mcpServers": {
    "ros-mcp-server": {
      "command": "uvx",
      "args": [
        "ros-mcp==3.1.2"
      ]
    }
  }
}

claude mcp add ros-mcp -- uvx ros-mcp --transport=stdio

This is third-party code. Review the repository files before installing.

What it does

The server gives the agent two-way access to a robot running ROS through a rosbridge node, without changing the robot's source code. The agent can publish and subscribe to topics, call services and actions, set parameters, read sensor data and monitor robot state in real time. It helps the model discover the available topics, services, actions and their types, including custom ones, so it can address them with the right syntax and no manual setup. It works with ROS 2, such as Jazzy and Humble, and ROS 1 distributions; the link runs over WebSocket, so the agent and the robot can sit on different machines in one network.

Who it is for. For robotics engineers and ROS developers who want to control a robot and inspect its state through an agent.

Example request

Connect to the robot on localhost through ros-mcp and show which topics and services are available

Limitations

The robot machine must have ROS installed and rosbridge running together with rosapi, or the introspection tools fail. Rosbridge is started through its launch file, not ros2 run, otherwise rosapi does not come up. Installing the server needs Python 3.10 or newer and pip 23.0 or newer. Controlling a real robot needs care: the agent can move mechanisms and change parameters. ROS 1 is declared end of life.

How to disable. Run claude mcp remove ros-mcp or delete the ros-mcp entry from the client's MCP configuration. If installed via pip, uninstall the ros-mcp package.

MCP

Transport

stdio, http

Authentication

not required

Security check

• Controls a real robot: publishes to topics, calls services and actions, sets parameters
• A wrong command can cause unwanted movement of mechanisms

README in short

The README describes a server that connects large language models to robots through MCP and ROS without changing the robot's code. It claims two-way communication: publishing and subscribing to topics, calling services and actions, working with parameters, and reading sensors and state. The server helps the model discover topics, services and their types, including custom ones, and works with ROS 2 and ROS 1. It shows examples with an industrial robot, the Wilson mobile robot and a Unitree Go2 quadruped in NVIDIA Isaac Sim. Setup goes through uvx or pip, with rosbridge and rosapi on the robot. Apache 2.0 licensed.

Related