Skip to main content
Glama

WiseVision/mcp_server_ros_2

by wise-vision
Mozilla Public License 2.0
33

WiseVision ROS2 MCP Server

ROS 2 Humble ROS 2 Jazzy

Flow graph

Python server implementing Model Context Protocol (MCP) for ROS2.

🚀 Enjoying this project?
You’re welcome to try the Pro version with extra features and priority support.
👉 Get Pro here

Real-world examples:

Demo

Features

  • List available topics
  • List available services
  • Call service
  • Get messages from WiseVision Data Black Box (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.

🔧 ROS 2 Tools

📋 Topics
ToolDescriptionInputsOutputs
ros2_topic_listReturns list of available topicstopic_name (string): Topic name topic_type (string): Message type
ros2_topic_subscribeSubscribes to a ROS 2 topic and collects messages for a duration or message limittopic_name (string) duration (float) message_limit (int) (defaults: first msg, 5s)messages count duration
ros2_get_messagesRetrieves 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_fieldsGets field names and types for a message typemessage_type (string)Field names + types
ros2_topic_publishPublishes message to a topictopic_name (string) message_type (string) data (dict)status

🛠 Services
ToolDescriptionInputsOutputs
ros2_service_listReturns list of available servicesservice_name (string) service_type (string) request_fields (array)
ros2_service_callCalls a ROS 2 serviceservice_name (string) service_type (string) fields (array) force_call (bool, default: false)result (string) error (string, if any)

Usage

MCP Server Configuration

Note

The server is running inside a Docker container as the root user. To communicate with other ROS components, they must also be run as root.

Note

Due to this issue, this MCP server doesn't work with Copilot in Visual Studio Code.

Docker run

Set MCP setting to mcp.json.

"mcp_server_ros_2": { "command": "docker", "args": [ "run", "-i", "--rm", "wisevision/mcp_server_ros_2" ], }

Build docker image locally

git clone https://github.com/wise-vision/mcp_server_ros_2.git cd mcp_server_ros_2 docker build -t wisevision/mcp_server_ros_2 .

Add this to AI Agent prompt:

You are an AI assistant that uses external tools via an MCP server. Before calling any tool, always check your memory to see if the list of available tools is known. • If you don’t have the current tool list in memory, your first action should be to call the list-tools tool. • Never guess tool names or parameters. • If a user requests something that may require a tool and you don’t have the right tool info, ask them or call list-tools first. Once the tool list is loaded, you may call tools directly using their documented names and schemas.

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

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Public implementation of MCP for ROS 2 enabling to interact with system visible various robots, capable of:

List available topics List available services Call service Subscribe topic to get messages Publish message on topic

and more

  1. Real-world examples:
    1. Features
      1. 🔧 ROS 2 Tools
      2. Usage
    2. Debugging

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        MCP server that integrates Microsoft Teams messaging (read, post, mention, list members and threads)
        Last updated -
        6
        307
        Apache 2.0
        • Linux
        • Apple
      • A
        security
        A
        license
        A
        quality
        Miro MCP server, exposing all functionalities available in official Miro SDK.
        Last updated -
        97
        596
        40
        Apache 2.0
        • Apple

      View all related MCP servers

      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/wise-vision/mcp_server_ros_2'

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