MCPHub Lab
MCPHub LabRegistryros-mcp-server
robotmcp

ros mcp server

Built by robotmcp ā€¢ 1,118 stars

Visit Repository

What is ros mcp server?

Connect AI models like Claude & GPT with robots using MCP and ROS.

How to use ros mcp server?

1. Install a compatible MCP client (like Claude Desktop). 2. Open your configuration settings. 3. Add ros mcp server using the following command: npx @modelcontextprotocol/ros-mcp-server 4. Restart the client and verify the new tools are active.
šŸ›”ļø Scoped (Restricted)
npx @modelcontextprotocol/ros-mcp-server --scope restricted
šŸ”“ Unrestricted Access
npx @modelcontextprotocol/ros-mcp-server

Key Features

Native MCP Protocol Support
Real-time Tool Activation & Execution
Verified High-performance Implementation
Secure Resource & Context Handling

Optimized Use Cases

Extending AI models with custom local capabilities
Automating system workflows via natural language
Connecting external data sources to LLM context windows

ros mcp server FAQ

Q

Is ros mcp server safe?

Yes, ros mcp server follows the standardized Model Context Protocol security patterns and only executes tools with explicit user-granted permissions.

Q

Is ros mcp server up to date?

ros mcp server is currently active in the registry with 1,118 stars on GitHub, indicating its reliability and community support.

Q

Are there any limits for ros mcp server?

Usage limits depend on the specific implementation of the MCP server and your system resources. Refer to the official documentation below for technical details.

Official Documentation

View on GitHub

ROS MCP Server šŸ§ ā‡„šŸ¤–

Static Badge Static Badge Static Badge Python pip Dev Container GitHub Repo stars GitHub last commit

<!-- 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, 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 - Controlling the MOCA mobile manipulator in NVIDIA Isaac Sim
Commands are entered into Claude Desktop, which uses the MCP server to control the simulated robot.

<p align="center"> <img src="https://github.com/robotmcp/ros-mcp-server/blob/main/docs/images/result.gif" /> </p>

šŸ• Example - Controlling Unitree Go2 with natural language (video)
The MCP server enables Claude to interpret images from the robot's cameras, and then command the robot based on human natural language commands.

<p align="left"> <img src="https://contoro.com/asset/media/demo_go2.gif" /> </p>

šŸ­ Example - Debugging an industrial robot (Video)

  • Connecting to an industrial robot enables the LLM to browse all ROS topics and services to assess the robot state.
  • With no predefined context, the MCP server enables the LLM to query details about custom topic and service types and their syntax (00:28).
  • Using only natural language, the operator calls the custom services to test and debug the robot (01:42).
<p align="center"> <a href="https://contoroinc.sharepoint.com/:v:/s/SandboxNewBusiness/EVh2t2_YG9BEl-Bw-8k6xucBcEv7XebJv1MtqLTIfrQpig?e=deu3YO"> <img src="https://github.com/robotmcp/ros-mcp-server/blob/main/docs/images/Contoro_robot.png" width="400" alt="Testing and debugging an industrial robot" /> </a> </p>

šŸ›  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.

<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 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.

Global Ranking

-
Trust ScoreMCPHub Index

Based on codebase health & activity.

Manual Config

{ "mcpServers": { "ros-mcp-server": { "command": "npx", "args": ["ros-mcp-server"] } } }