Provides containerization support for running the MCP server in an isolated environment, allowing communication with ROS2 components running in the same Docker network.
Integrates with InfluxDB through the WiseVision Data Black Box as an alternative to Rosbag2 for storing and retrieving ROS2 messages.
Provides tools for interacting with ROS2 (Robot Operating System) nodes, enabling listing of topics and services, subscribing to topics, publishing messages, calling services, and retrieving data from WiseVision Data Black Box.
WiseVision ROS2 MCP Server
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:
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
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) |
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.
Build docker image locally
Add this to AI Agent prompt:
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:
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
This server cannot be installed
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
Related MCP Servers
- AsecurityAlicenseAqualityMCP server that integrates Microsoft Teams messaging (read, post, mention, list members and threads)Last updated -6307Apache 2.0
- AsecurityAlicenseAqualityMiro MCP server, exposing all functionalities available in official Miro SDK.Last updated -9759640Apache 2.0