Connect AI Language Models with Robots on ROS using MCP
Project description
ROS MCP Server 🧠⇄🤖
ROS-MCP-Server connects large language models (such as Claude, GPT, and Gemini) to robots, enabling bidirectional communication with no changes to existing robot source code.
Why ROS-MCP?
- No robot source code changes → just add the
rosbridgenode to your existing ROS setup. - True two-way communication → LLMs can both control robots and observe everything happening on the Robot.
- Full context → publish & subscribe to topics, call services & actions, set parameters, read sensor data, and monitor robot state in real time.
- Deep ROS understanding → guides the LLM to discover available topics, services, actions, and their types (including custom ones) — enabling it to use them with the right syntax without manual configuration.
- Works with any MCP client → built on the open MCP standard, supporting Claude Code, Codex CLI, Gemini CLI, Claude Desktop, ChatGPT, Cursor, and more.
- Works across ROS versions → compatible across ROS 2 (Jazzy, Humble, and others) and ROS 1 distros.
🎥 Examples in Action
🏭 Example - AI Agent diagnosis of Industrial Robot End Effector (Video)
- The MCP server connects Claude to a production industrial robot, with only the technician manuals as reference.
- Claude discovers the robot's custom topic and service types and their syntax on its own.
- From a single prompt to test the gripper, it reads the manuals, runs its own tests, finds an anomaly, and reports the root cause.
🤖 Example - Controlling "Wilson" with natural language (video)
From a single prompt — "Grab a Coke from the fridge & go to the living room." — Google Gemini uses the MCP server to navigate and manipulate autonomously. Built on ROS 2 with Nav2 (SLAM) for mapping and navigation, and MoveIt to command the manipulator.
🐕 Example - Controlling Unitree Go2 in NVIDIA Isaac Sim (video)
The MCP server connects Claude to a simulated Unitree Go2 quadruped in NVIDIA Isaac Sim, interpreting natural language commands to navigate and control the robot.
🛠 Getting Started
Follow the installation guide to get started.
ROS-MCP works with Claude Code, Codex CLI, Gemini CLI, Claude Desktop, ChatGPT, Cursor, or any MCP-compatible client.
📚 More Examples & Tutorials
Browse our examples to see the server in action.
We welcome community PRs with new examples and integrations!
🤝 Contributing
We love contributions of all kinds:
- Bug fixes and documentation updates
- New features (e.g., Action support, permissions)
- Additional examples and tutorials
Check out the contributing guidelines and see issues tagged good first issue to get started.
📜 License
This project is licensed under the Apache License 2.0.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ros_mcp-3.1.0.tar.gz.
File metadata
- Download URL: ros_mcp-3.1.0.tar.gz
- Upload date:
- Size: 62.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
156382747d4283359695ec94040de708441a5b3ded0ffe43f749850879680336
|
|
| MD5 |
fcbf3823ca0e7b99d5da4c204b2fa27e
|
|
| BLAKE2b-256 |
43916e510004473fb7b7093e8dac9202c03e722087437ebb994e7cfa04908e8e
|
Provenance
The following attestation bundles were made for ros_mcp-3.1.0.tar.gz:
Publisher:
publish.yml on robotmcp/ros-mcp-server
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ros_mcp-3.1.0.tar.gz -
Subject digest:
156382747d4283359695ec94040de708441a5b3ded0ffe43f749850879680336 - Sigstore transparency entry: 1855584796
- Sigstore integration time:
-
Permalink:
robotmcp/ros-mcp-server@f1c023bb5570794ee4d935aa2c7c06e025810952 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/robotmcp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f1c023bb5570794ee4d935aa2c7c06e025810952 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file ros_mcp-3.1.0-py3-none-any.whl.
File metadata
- Download URL: ros_mcp-3.1.0-py3-none-any.whl
- Upload date:
- Size: 78.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
76f14634e7f8dabd4919ffef0cc3433da449c172383229a5a53ab7b171602b80
|
|
| MD5 |
320ede61fe50991eabf600a54930c739
|
|
| BLAKE2b-256 |
01c55bea3416d79d7f34b08ba3a1f0b22169536008635e43805db27db7a9eeb5
|
Provenance
The following attestation bundles were made for ros_mcp-3.1.0-py3-none-any.whl:
Publisher:
publish.yml on robotmcp/ros-mcp-server
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ros_mcp-3.1.0-py3-none-any.whl -
Subject digest:
76f14634e7f8dabd4919ffef0cc3433da449c172383229a5a53ab7b171602b80 - Sigstore transparency entry: 1855584816
- Sigstore integration time:
-
Permalink:
robotmcp/ros-mcp-server@f1c023bb5570794ee4d935aa2c7c06e025810952 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/robotmcp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f1c023bb5570794ee4d935aa2c7c06e025810952 -
Trigger Event:
workflow_dispatch
-
Statement type:
