Ros2mcp

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

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

[](https://www.youtube.com/watch?v=yN2vLpf2-HE)

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:

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ngres
• Source: ngres/ros2mcp
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.