Ros MCP server

by robotmcp·io.github.robotmcp/ros-mcp-server·v3.1.2·1.5k stars

No reviews yet

Connect AI models like Claude & ChatGPT with ROS robots using MCP

A94/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A94/100

full report

Adoption

Established

1.5k stars

Reviews

Write one

Nobody has reviewed Ros yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Ros tools (31, 5 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

call_service
Call a ROS service with specified request data.
cancel_action_goalwrite action
Cancel a specific action goal. Works only with ROS 2.
connect_to_robot
Connect to a robot by setting the IP and port for the WebSocket connection, then testing connectivity.
delete_parameterwrite action
Delete a ROS parameter. Works only with ROS 2.
detect_ros_version
Detect the ROS version and distribution via rosbridge.
get_action_details
Get complete action details including goal, result, and feedback structures.
get_action_status
Get action status for a specific action name. Works only with ROS 2.
get_actions
Get list of all available ROS actions.
get_message_details
Get the complete structure/definition of a message type.
get_node_details
Get detailed information about a specific node including its publishers, subscribers, and services.
get_nodes
Get list of all currently running ROS nodes.
get_parameter
Get a single ROS parameter value by name. Works only with ROS 2.
get_parameter_details
Get comprehensive details about a specific ROS parameter including value, type, and metadata. Works only with ROS 2.
get_parameters
Get list of all ROS parameter names for a specific node. Works only with ROS 2.
get_service_details
Get complete service details including request/response structures and provider nodes.
get_service_type
Get the service type for a specific service.
get_services
Get list of all available ROS services.
get_topic_details
Get detailed information about a specific topic including its type, publishers, and subscribers.
get_topic_type
Get the message type for a specific topic.
get_topics
Fetch available topics from the ROS bridge.
get_verified_robot_spec
Load pre-defined specifications and additional context for a verified robot model.
get_verified_robots_list
List all pre-verified robot models that have specification files available in the repository.
has_parameter
Check if a ROS parameter exists. Works only with ROS 2.
ping_robots
Ping one or more IP addresses and check if specific ports are open.
publish_for_durationswrite action
Publish a sequence of messages to a given ROS topic for specified durations.
publish_oncewrite action
Publish a single message to a ROS topic via rosbridge.
send_action_goalwrite action
Send a goal to a ROS action server. Works only with ROS 2.
set_parameter
Set a single ROS parameter value. Works only with ROS 2.
subscribe_for_duration
Subscribe to a ROS topic via rosbridge for a fixed duration and collect messages.
subscribe_once
Subscribe to a given ROS topic via rosbridge and return the first message received.
view_saved_image

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings

Code scan36 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 0 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Overall 94/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Ros compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 94/100; higher than 96% of 48,255 servers
Tools: 31; the typical server has 7
Tools that change things: 16%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 1,474; more than 95% of 28,688 servers

What its tools let an agent do: 25 read · 1 change · 2 delete · 3 send or post

Release history: 2 versions in the registry since 2026-06-18, latest 2026-09-23, typically one every 98 days.

Install Ros in Claude Code, Cursor or VS Code

claude mcp add ros-mcp-server -- uvx ros-mcp

Add to Cursor

What the publisher says

From the Ros repository's README, as published. We do not edit it. Read it on GitHub

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

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Ros: common questions

Is Ros MCP server safe?: Yes, by our scan: it is graded A (94/100). Read the Ros safety report
How do I install Ros?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Ros need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Ros maintained?: The last commit was 41 days ago (2026-09-23). The latest release is v3.1.2.
How does Ros compare with other MCP servers?: safety score 94/100 (higher than 96% of 48,255 servers); tools 31 (the typical server has 7); tools that change things 16% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.