Advertise
MCP.so
Sign In

Ros2 MCP Server

@kakimochi

Repository

Basic information

Category

Other

Transports

stdio

Author

kakimochi

About Ros2 MCP Server

No overview available yet

Ros2 MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ros2-mcp-server": {
      "command": "uv",
      "args": [
        "venv",
        "--python",
        "/usr/bin/python3.10"
      ]
    }
  }
}

Ros2 MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ros2-mcp-server?

ros2-mcp-server is a Python-based server that integrates the Model Context Protocol (MCP) with ROS 2, enabling AI assistants to control robots via ROS 2 topics. It processes commands through FastMCP and runs as a ROS 2 node, publishing geometry_msgs/Twist messages to the /cmd_vel topic to control robot movement.

How to use ros2-mcp-server?

Install dependencies and configure the server as an MCP transport in your client (e.g., Claude Desktop or Cline in VSCode) using the provided JSON block with uv and a bash command that sources ROS 2 and runs the script. Then send natural language movement commands or use the move_robot tool directly with linear/angular velocity and duration.

Key features of ros2-mcp-server

  • MCP integration via FastMCP for AI assistant commands.
  • Operates as a ROS 2 node publishing to /cmd_vel.
  • Supports time‑based movement with duration and stop.
  • Asynchronous processing using asyncio and ROS 2 event loop.
  • Uses stdio transport for MCP client communication.
  • Compatible with ROS 2 Humble and Python 3.10.

Use cases of ros2-mcp-server

  • Command a robot to move forward for a specific duration.
  • Test robot movement in Gazebo with TurtleBot3.
  • Integrate an AI assistant like Claude with a physical robot.
  • Prototype voice or text‑driven robot navigation tasks.

Frequently asked questions

1

What ROS 2 distribution is required?

ROS 2 Humble must be installed and sourced.

2

What Python version is needed?

Python 3.10 is required for compatibility with ROS 2 Humble.

3

What topic does the server publish to?

It publishes `geometry_msgs/Twist` messages to the `/cmd_vel` topic.

4

Can I use other topics or services?

Currently only `/cmd_vel` is supported. Extend `ros2-mcp-server.py` to add other topics or services.

5

How do I verify the robot is receiving commands?

Run `ros2 topic echo /cmd_vel` to monitor the published twist messages.

Comments

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

ICSS

chokcoco

不止于 CSS

20.7K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Advertise