ros2_mcp

Overview

ros2_mcp is a comprehensive Python implementation of the Model Context Protocol for ROS 2, designed to seamlessly integrate AI agents with robotics systems. The server exposes numerous tools for interacting with ROS 2 nodes, topics, services, and actions, enabling AI systems to control robots, analyze sensor data, and debug systems through natural language interfaces. With features like auto type discovery, nested field support, and built-in data analysis capabilities, it significantly reduces the complexity of AI-robot interactions.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• ros2_topic_list

  Returns list of available topics with their names and message types

  Try:List all available topicsTry:What topics are available in this ROS 2 system?
• ros2_topic_subscribe

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

  Try:Subscribe to /scan topic for 10 secondsTry:Get 50 messages from /odom topic
• ros2_get_messages

  Retrieves past messages from a topic (from data black box)

  Try:Get last 100 messages from /camera/image_rawTry:Retrieve messages from /tf between 10:00 and 10:05
• ros2_get_message_fields

  Gets field names and types for a message type

  Try:Show me the fields of sensor_msgs/LaserScanTry:What fields are in nav_msgs/Odometry?
• ros2_topic_publish

  Publishes message to a topic

  Try:Publish to /cmd_vel with linear x=0.2 and angular z=0.1Try:Send a message to /chatter with text 'Hello'
• ros2_service_list

  Returns list of available services with their names, types, and request fields

  Try:List all available servicesTry:What services are in this ROS 2 system?
• ros2_service_call

  Calls a ROS 2 service with specified fields

  Try:Call /spawn service with x=1.0 y=2.0Try:Get robot state from /get_robot_state service
• ros2_list_actions

  Returns list of available ROS 2 actions with their types and request fields

  Try:List all available actionsTry:What actions are available in this system?
• ros2_send_action_goal

  Sends a goal to an action. Optionally waits for the result

  Try:Send move_base goal to x=3.0 y=4.0Try:Navigate to coordinate (5,5) with timeout 30s
• ros2_cancel_action_goal

  Cancels a specific goal or all goals for an action

  Try:Cancel all goals for move_base actionTry:Cancel specific goal with ID 12345
• ros2_action_subscribe_feedback

  Subscribes to feedback messages for an action

  Try:Get feedback for move_base actionTry:Subscribe to navigation feedback for 10 seconds
• ros2_action_subscribe_status

  Subscribes to an action's status topic and returns collected status frames

  Try:Check status of move_base actionTry:Get action status updates for 5 seconds

Comparable tools

Installation

pip install mcp_ros2

{
  "mcpServers": {
    "ros2": {
      "command": "python",
      "args": ["-m", "mcp_ros2.server"],
      "env": {
        "ROS_DOMAIN_ID": "0"
      }
    }
  }
}

FAQ

What ROS 2 versions are supported?

ROS 2 Humble and Jazzy are officially supported. The server is designed to work with standard ROS 2 installations.

Can I use custom ROS 2 message types?

Yes, source the package that defines your custom message type before starting the server, and it will be automatically discovered.

Compare ros2_mcp with