ROS2 MCP
An open-source Model Context Protocol server that enables AI agents to interact with ROS 2 robots. It allows agents to list, subscribe to, publish on, and call ROS 2 topics, services, and actions directly through rclpy without requiring rosbridge or changes to the robot's software.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 98 GitHub stars
What you can do with it
- List ROS 2 topics, services, and actions
- Subscribe to and read messages from ROS 2 topics
- Publish messages to ROS 2 topics
- Call ROS 2 services and actions
Source and maintenance
- Last repository push
- Latest release
- 2610
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
docker.io/mcp/ros2:latest
{
"transport": "stdio",
"identifier": "docker.io/mcp/ros2:latest",
"runtimeHint": "docker",
"registryType": "oci",
"runtimeArguments": [
{
"name": "-v",
"type": "named",
"value": "~/mcp_custom_messages:/app/custom_msgs",
"description": "Mount custom messages directory"
}
],
"environmentVariables": [
{
"name": "MCP_CUSTOM_PROMPTS",
"value": "false",
"description": "Enable custom prompts"
},
{
"name": "MCP_PROMPTS_LOCAL",
"value": "false",
"description": "Use local prompts"
},
{
"name": "MCP_PROMPTS_PATH",
"value": "/app/ros2_mcp_prompts",
"description": "Path to custom prompts directory"
},
{
"name": "MCP_PROMPTS_MODULE",
"value": "extension_prompts",
"description": "Name of the prompts module"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"ros2-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_CUSTOM_PROMPTS=<YOUR_MCP_CUSTOM_PROMPTS>",
"-e",
"MCP_PROMPTS_LOCAL=<YOUR_MCP_PROMPTS_LOCAL>",
"-e",
"MCP_PROMPTS_PATH=<YOUR_MCP_PROMPTS_PATH>",
"-e",
"MCP_PROMPTS_MODULE=<YOUR_MCP_PROMPTS_MODULE>",
"docker.io/mcp/ros2:latest"
],
"env": {
"MCP_CUSTOM_PROMPTS": "<YOUR_MCP_CUSTOM_PROMPTS>",
"MCP_PROMPTS_LOCAL": "<YOUR_MCP_PROMPTS_LOCAL>",
"MCP_PROMPTS_PATH": "<YOUR_MCP_PROMPTS_PATH>",
"MCP_PROMPTS_MODULE": "<YOUR_MCP_PROMPTS_MODULE>"
}
}
}
}Cline
{
"mcpServers": {
"ros2-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_CUSTOM_PROMPTS=<YOUR_MCP_CUSTOM_PROMPTS>",
"-e",
"MCP_PROMPTS_LOCAL=<YOUR_MCP_PROMPTS_LOCAL>",
"-e",
"MCP_PROMPTS_PATH=<YOUR_MCP_PROMPTS_PATH>",
"-e",
"MCP_PROMPTS_MODULE=<YOUR_MCP_PROMPTS_MODULE>",
"docker.io/mcp/ros2:latest"
],
"env": {
"MCP_CUSTOM_PROMPTS": "<YOUR_MCP_CUSTOM_PROMPTS>",
"MCP_PROMPTS_LOCAL": "<YOUR_MCP_PROMPTS_LOCAL>",
"MCP_PROMPTS_PATH": "<YOUR_MCP_PROMPTS_PATH>",
"MCP_PROMPTS_MODULE": "<YOUR_MCP_PROMPTS_MODULE>"
}
}
}
}VS Code
{
"servers": {
"ros2-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_CUSTOM_PROMPTS=<YOUR_MCP_CUSTOM_PROMPTS>",
"-e",
"MCP_PROMPTS_LOCAL=<YOUR_MCP_PROMPTS_LOCAL>",
"-e",
"MCP_PROMPTS_PATH=<YOUR_MCP_PROMPTS_PATH>",
"-e",
"MCP_PROMPTS_MODULE=<YOUR_MCP_PROMPTS_MODULE>",
"docker.io/mcp/ros2:latest"
],
"env": {
"MCP_CUSTOM_PROMPTS": "<YOUR_MCP_CUSTOM_PROMPTS>",
"MCP_PROMPTS_LOCAL": "<YOUR_MCP_PROMPTS_LOCAL>",
"MCP_PROMPTS_PATH": "<YOUR_MCP_PROMPTS_PATH>",
"MCP_PROMPTS_MODULE": "<YOUR_MCP_PROMPTS_MODULE>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"ros2-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_CUSTOM_PROMPTS=<YOUR_MCP_CUSTOM_PROMPTS>",
"-e",
"MCP_PROMPTS_LOCAL=<YOUR_MCP_PROMPTS_LOCAL>",
"-e",
"MCP_PROMPTS_PATH=<YOUR_MCP_PROMPTS_PATH>",
"-e",
"MCP_PROMPTS_MODULE=<YOUR_MCP_PROMPTS_MODULE>",
"docker.io/mcp/ros2:latest"
],
"env": {
"MCP_CUSTOM_PROMPTS": "<YOUR_MCP_CUSTOM_PROMPTS>",
"MCP_PROMPTS_LOCAL": "<YOUR_MCP_PROMPTS_LOCAL>",
"MCP_PROMPTS_PATH": "<YOUR_MCP_PROMPTS_PATH>",
"MCP_PROMPTS_MODULE": "<YOUR_MCP_PROMPTS_MODULE>"
}
}
}
}Let your agent find its tools
Find servers like ROS2 MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.