Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Ros2mcp

FreeNot checked

Expose arbitrary ROS 2 services and topics as MCP tools and list topics as resources.

GitHubEmbed

About

Expose arbitrary ROS 2 services and topics as MCP tools and list topics as resources.

README

ros2mcp ros2mcp

Expose arbitrary ROS 2 services and topics as MCP tools and list topics as resources.

Example of ROS to MCP translation

The mcp_server node can translate any ROS topic and service into a MCP resource or tool (including source comments as parameter descriptions).

Demo Video with TurtleBot4 and Gazebo

Demo Setup

The demo can be run on Linux, macOS, and Windows using Pixi.

  1. Clone the repository.
git clone https://github.com/nico0302/ros2mcp.git
  1. Start Gazebo and Rviz2 and the demo node:
pixi run demo-tb4

This might take a while on the first run as it downloads the necessary assets.

  1. After Gazebo and Rviz2 are running, select the 2D Pose Estimate tool in Rviz2 to set the robot's initial position by clicking in the center of the map and dragging to right: Rviz2 selecting 2D pose estimate

  2. Connect a MCP client to the demo server on http://localhost:8080 This project includes a simple MCP client that can be run with:

# make sure to set your OPENAI_API_KEY environment variable
export OPENAI_API_KEY=your_openai_api_key
pixi run demo-client

from github.com/ngres/ros2mcp

Installing Ros2mcp

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/ngres/ros2mcp

FAQ

Is Ros2mcp MCP free?

Yes, Ros2mcp MCP is free — one-click install via Unyly at no cost.

Does Ros2mcp need an API key?

No, Ros2mcp runs without API keys or environment variables.

Is Ros2mcp hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Ros2mcp in Claude Desktop, Claude Code or Cursor?

Open Ros2mcp on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Ros2mcp with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs