What ROS 2 distribution is required?

ROS 2 Humble must be installed and sourced.

What Python version is needed?

Python 3.10 is required for compatibility with ROS 2 Humble.

What topic does the server publish to?

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

What credentials does it need?

It reads `ROS_LOG_DIR`, `TURTLEBOT3_MODEL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

Ros2 MCP Server — Tools & Setup

What is the Ros2 MCP Server?

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

What the server does

MCP Integration — Uses FastMCP to handle commands from MCP clients (e.g., Claude)
ROS 2 Native — Operates as a ROS 2 node, directly publishing to /cmd_vel
Time-Based Control — Supports duration-based movement commands (e.g., move for a specified time and stop)
Asynchronous Processing — Combines FastMCP's asyncio with ROS 2's event loop for efficient operation

Credentials and setup notes

ROS 2: Humble distribution installed and sourced. - Python: Version 3.10 (required for compatibility with ROS 2 Humble). - uv: Python package manager for dependency management. - Dependencies: - rclpy: ROS 2 Python client library (installed with ROS 2). - fastmcp: FastMCP framework for MCP server implementation. - numpy: Required by ROS 2 message types.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Configuration

ROS 2: Humble distribution installed and sourced. - Python: Version 3.10 (required for compatibility with ROS 2 Humble). - uv: Python package manager for dependency management. - Dependencies: - rclpy: ROS 2 Python client library (installed with ROS 2). - fastmcp: FastMCP framework for MCP server implementation. - numpy: Required by ROS 2 message types.

Variable	Description	Required
ROS_LOG_DIR	Filesystem location the server is allowed to use.	Optional
TURTLEBOT3_MODEL	Configuration value read at startup.	Optional

Ros2 MCP Server

What is the Ros2 MCP Server?

What the server does

Credentials and setup notes

More MCP options

Configuration

Frequently asked questions

Alternatives to the Ros2 MCP Server

Filesystem

Context7

Playwright

GitHub

Supabase

Linear