WiseVision/mcp_server_ros_2

WiseVision ROS2 MCP Server

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

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.

API

Tools

• ros2_topic_list
  • Retrun list of available topics
  • Output:
    • topic_name (string): Topic name
    • topic_type (string): Message topic type
• ros2_service_list
  • Retruns list available services
  • Output:
    • service_name (string): Service name
    • service_type (string): Service type
    • request_fields (string array): Fields in service
• ros2_service_call
  • Call ros2 service
  • Inputs:
    • service_name (string): Service name
    • service_type (string): Service type
    • fields (string array): Fields in service request filled with user data
    • force_call (bool): Force service call without every field in service field up, Default set to false
  • Output:
    • result (string): Return result of the service call
    • error (string): Return error in case of error
  • Features:
    • Check if service exists
    • Check if every field in service is provide
• ros2_topic_subscribe
  • Subscribes to a ROS 2 topic and collects messages either for a duration or a message limit.
  • Inputs:
    • topic_name (string): Topic name
    • msg_type (string): Message type
    • duration (float): How long subscribe topic
    • message_limit (int): How many messages collect
    • Default to collect first message, waiting 5 seconds
  • Output:
    • messages: Serialized messages from topic
    • count: Number of collected messages
    • duration: How long messages has been collected
• ros2_get_messages
  • Inputs:
    • topic_name (string): Topic name
    • message_type (string): Message type
    • number_of_msg(int): How many messages get from data black box
    • time_start (str): Start time for data retrieval. Only messages with timestamps after this will be returned
    • time_end (str): End time for data retrieval. Only messages with timestamps before this will be returned
  • Output:
    • timestamps: Time values used to indicate when each message was created, recorded, or received. Typically represented as ISO 8601 strings or UNIX epoch times. Used for filtering, ordering, and synchronizing data.
    • messages: Individual units of published data in ROS 2 topics. Each message contains a structured payload defined by its message type (e.g., std_msgs/msg/String).
• ros2_get_message_fields
  • Inputs:
    • message_type (string): Message type
  • Output:
    • Returns the field names and types for a given ROS 2 message request type
• ros2_topic_publish
  • Inputs:
    • topic_name (string): Topic name
    • message_type (string): Message type
    • data (dict): Dictionary with message fields
  • Output:
    • status: Status of publication
• ros2_topic_echo_wait
  • Inputs:
    • topic_name (string): Topic name
    • message_type (string): Message type
    • timeout (float): Duration to wait for a message before giving up.
  • Output:
    • message: The deserialized ROS 2 message, converted to a Python dictionary (via message_to_ordereddict)
    • received: true, indicating the message was successfully received

Usage

MCP Server Configuration

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.