Skip to main content
Glama

ROS2 MCP Server

by gavindev14

ROS2 MCP Server

ROS 2 Humble ROS 2 Jazzy

Flow graph

A Python implementation of the Model Context Protocol (MCP) for ROS2. This server enables AI tooling to connect with ROS2 nodes, topics, and services using the MCP standard over stdio. It is designed to be the easiest ROS2 server to configure in the world.

🎯 Why Choose This MCP Server?

Save hours of development time with native AI integration for your ROS2 projects:

  • ⚡ 1-minute setup - World's easiest ROS2 MCP configuration

  • 0️⃣ Zero-friction setup - stdio transport, no brokers, no webserver.

  • 🔌 Auto-discovery - a built-in “list interfaces” tool dynamically enumerates available topics and services together with their message/service definitions (fields, types, schema) — so the client always knows exactly what data can be published or called.

  • 🤖 AI-powered debugging - Let AI help you troubleshoot ROS2 issues in real-time

  • 📊 Smart data analysis - Query your robot's sensor data using natural language

  • 🚀 Boost productivity - Control robots, analyze logs, and debug issues through AI chat

  • 💡 No ROS2 expertise required - AI translates your requests into proper ROS2 commands

Perfect for: Robotics developers, researchers, students, and anyone working with ROS2 who wants to leverage AI for faster development and debugging.

🌍 Real-world examples:

Demo

✨ Features

  • List available topics

  • List available services

  • Call service

  • Get messages from data storage systems (influxDB alternative to Rosbag2)

  • Subscribe topic to get messages

  • Publish message on topic

  • Echo message on topic

  • Get fields from message type

Note: To call service with custom service source it before start server.

⚙️ Installation

Follow the installation guide for step-by-step instructions:

🔧 ROS 2 Tools

📋 Topics

Tool

Description

Inputs

Outputs

ros2_topic_list

Returns list of available topics

topic_name

(string): Topic name

topic_type

(string): Message type

ros2_topic_subscribe

Subscribes to a ROS 2 topic and collects messages for a duration or message limit

topic_name

(string)

duration

(float)

message_limit

(int)

(defaults: first msg, 5s)

messages

count

duration

ros2_get_messages

Retrieves past messages from a topic (data black box)

topic_name

(string)

message_type

(string)

number_of_msg

(int)

time_start

(str)

time_end

(str)

timestamps

messages

ros2_get_message_fields

Gets field names and types for a message type

message_type

(string)

Field names + types

ros2_topic_publish

Publishes message to a topic

topic_name

(string)

message_type

(string)

data

(dict)

status


🛠 Services

Tool

Description

Inputs

Outputs

ros2_service_list

Returns list of available services

service_name

(string)

service_type

(string)

request_fields

(array)

ros2_service_call

Calls a ROS 2 service

service_name

(string)

service_type

(string)

fields

(array)

force_call

(bool, default: false)

result

(string)

error

(string, if any)

🐞 Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via with this command:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_server_ros2 run mcp_ros_2_server

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables AI tools to interact with ROS2 robotics systems through natural language commands. Supports topic publishing/subscribing, service calls, message analysis, and auto-discovery of ROS2 interfaces for debugging and controlling robots.

  1. 🎯 Why Choose This MCP Server?
    1. 🌍 Real-world examples:
      1. ✨ Features
        1. ⚙️ Installation
          1. 🔧 ROS 2 Tools
        2. 🐞 Debugging

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/gavindev14/mcp_server_ros_2'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server