ros-mcp-server
Connect AI models like Claude & GPT with robots using MCP and ROS.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/robotmcp/ros-mcp-server with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/robotmcp/ros-mcp-server'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/robotmcp--ros-mcp-server)HTML
<a href="/listings/robotmcp--ros-mcp-server"><img src="/api/listings/robotmcp--ros-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 105 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # ROS MCP Server 🧠⇄🤖
- 
- 
- 
- 
- 
- 
- 
- 
- <!-- mcp-name: io.github.robotmcp/ros-mcp-server -->
- <p align="center">
- <img src="https://github.com/robotmcp/ros-mcp-server/blob/main/docs/images/framework.png"/>
- </p>
- 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 `rosbridge` node 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](https://modelcontextprotocol.io/), 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
- <p align="center">
- <a href="https://youtu.be/Yy1loJAn9sA">
- <img src="https://github.com/robotmcp/ros-mcp-server/blob/main/docs/images/MCP%20Demos%20Slide%20-%207to12s.gif" alt="ROS MCP demos" />
- </a>
- </p>
- ---
- 🏭 **Example - AI Agent diagnosis of Industrial Robot End Effector** ([Video](https://youtu.be/EhZNFULz9P4))
- - 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.
- <p align="center">
- <a href="https://youtu.be/EhZNFULz9P4">
- <img src="https://github.com/robotmcp/ros-mcp-server/blob/main/docs/images/ROS%20MCP%20Gripper%20vacuum%20test.jpg" width="400" alt="Testing and debugging an industrial robot" />
- </a>
- </p>
- ---
- 🤖 **Example - Controlling "Wilson" with natural language** ([video](https://www.traceglarue.com/wilson))
- 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.
- <p align="center">
- <a href="https://www.traceglarue.com/wilson">
- <img src="https://github.com/robotmcp/ros-mcp-server/blob/main/docs/images/Wilson%20thumbnail.jpg" width="400" alt="Wilson robot controlled with natural language" />
- </a>
- </p>
- ---
- 🐕 **Example - Controlling Unitree Go2 in NVIDIA Isaac Sim** ([video](https://www.youtube.com/watch?v=9StFx4lnvmc))
- 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.
- <p align="center">
- <a href="https://www.youtube.com/watch?v=9StFx4lnvmc">
- <img src="https://img.youtube.com/vi/9StFx4lnvmc/maxresdefault.jpg" width="400" alt="Controlling Unitree Go2 in NVIDIA Isaac Sim" />
- </a>
- </p>
- ---
- ## 🛠 Getting Started
- Follow the [installation guide](docs/install/installation.md) to get started.
- ROS-MCP works with Claude Code, Codex CLI, Gemini CLI, Claude Desktop, ChatGPT, Cursor, or any MCP-compatible client.
- <p align="center">
- <img src="https://github.com/robotmcp/ros-mcp-server/blob/main/docs/images/MCP_topology.png"/>
- </p>
- ---
- ## 📚 More Examples & Tutorials
- Browse our [examples](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](docs/contributing.md) and see issues tagged **good first issue** to get started.
- ---
- ## 📜 License
- This project is licensed under the [Apache License 2.0](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.