Yutarop/ros-mcp

Overview

A Python-based MCP server that exposes ROS (Robot Operating System) topics, services, and actions through the Model Context Protocol. It allows AI agents or MCP clients to send commands and receive data from a ROS environment, enabling programmatic robot control.

Best for

Best for
Developers building AI agents that need to interact with ROS-based robots

Use cases

• Controlling a robot's movement by publishing to cmd_vel topics
• Querying sensor data from ROS topics via an MCP client
• Triggering ROS services or actions from an AI agent

How to use

Install

git clone git@github.com:Yutarop/ros-mcp.git && cd ros-mcp && pip install "websockets>=15.0.1" && uv venv && source .venv/bin/activate && uv pip install -e .

Tools exposed

• uv
• pip

Tested with

Claude Desktop

Example client config

{\n  "mcpServers": {\n    "ros-general": {\n      "command": "uv",\n      "args": [\n        "--directory",\n        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/ros-mcp",\n        "run",\n        "bash",\n        "-c",\n        "export ROS_LOG_DIR=/tmp && export ROS_DOMAIN_ID=${ROS_DOMAIN_ID:-YOUR_ROS_DOMAIN_ID} && source /opt/ros/humble/setup.bash && python3 /ABSOLUTE/PATH/TO/PARENT/FOLDER/ros-general.py"\n      ]\n    }\n  }\n}

Notes

A Python-based MCP server that exposes ROS (Robot Operating System) topics, services, and actions through the Model Context Protocol. It allows AI agents or MCP clients to send commands and receive data from a ROS environment, enabling programmatic robot control.

32 stars on GitHub. Last updated 2025-08-19. Licensed MIT.

Use cases

• Controlling a robot’s movement by publishing to cmd_vel topics
• Querying sensor data from ROS topics via an MCP client
• Triggering ROS services or actions from an AI agent

Pros

• Bridges ROS with MCP for agent-based robot control
• Lightweight Python implementation with clear ROS integration
• Supports topics, services, and actions for comprehensive access

Cons

• Small community and limited documentation (32 stars)
• Requires a running ROS environment and MCP client setup
• Not actively maintained or widely tested beyond basic use cases

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.