# Ros Mcp

> MCP server for ROS to control robots via topics, services, and actions.

- **Type:** MCP server
- **Install:** `agentstack add mcp-yutarop-ros-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Yutarop](https://agentstack.voostack.com/s/yutarop)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Yutarop](https://github.com/Yutarop)
- **Source:** https://github.com/Yutarop/ros-mcp

## Install

```sh
agentstack add mcp-yutarop-ros-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## ROS MCP
[](https://archestra.ai/mcp-catalog/yutarop__ros-mcp)

**ROS MCP** is a MCP server designed for controlling robots in ROS environments using natural language. 
It supports communication via ROS topics, services, and actions, and works with any ROS message type.

## Demo
#### Test to see if ros topics, services, and actions can be used.
https://github.com/user-attachments/assets/61143c37-fb73-4998-9cbc-844d92ae61d9

##### Prompt used (Topic)
> Open gazebo with TurtleBot3 and publish topic to move it.

##### Prompt used (Service)
> Show me service list and call service to reset the world in Gazebo.

##### Prompt used (Action)
> Show me action list and call action to move the TurtleBot3 forward for 1m.

## Components
- **Socket Server** ([`socket_server.py`](https://github.com/Yutarop/ros-mcp/blob/main/src/socket_server.py)): A lightweight server that runs on localhost:8765 to handle GUI-related operations. 
It receives instructions from the MCP server to launch tools such as `Gazebo` or `rqt_graph` on the local display.

- **MCP Server** ([`ros-general.py`](https://github.com/Yutarop/ros-mcp/blob/main/ros-general.py)): A Python-based server that implements the MCP.
It processes natural language input, maps it to ROS commands, and communicates with the socket server.
To enable node communication between the MCP server and the local machine, both must be configured with the same `ROS_DOMAIN_ID` on the same local network.

## Overview of MCP Tools
- `Topic Management`: List, monitor, and publish to ROS2 topics
- `Node Control`: List and inspect running ROS2 nodes
- `Service Interaction`: Call ROS2 services with custom
- `Action Support`: Send goals to ROS2 actions
- `GUI Integration`: Launch ROS2 GUI tools via WebSocket server
- `Environment Debugging`: Check ROS2 setup and configuration
- `Process Management`: Clean up running ROS2 processes

Please refer [here](https://github.com/Yutarop/ros-mcp/wiki/Available-Tools) for more details.

## Getting Started
#### Requirements
- ROS2 Humble Hawksbill (This project has only been tested with ROS2 Humble. Compatibility with other ROS2 distributions is not guaranteed.)
- claude desktop ([Linux](https://github.com/aaddrick/claude-desktop-debian), [macOS](https://claude.ai/download) and [Windows](https://claude.ai/download))
- Python 3.10+
- websockets >= 15.0.1
- uv package manager ([Installing uv](https://docs.astral.sh/uv/getting-started/installation/))
- Other dependencies as listed in `pyproject.toml`

### Installation
#### Git clone and install websockets package
```bash
git clone git@github.com:Yutarop/ros-mcp.git
cd ros-mcp
pip install "websockets>=15.0.1"
```

#### Activate .venv and install dependencies
```bash
uv venv
source .venv/bin/activate
uv pip install -e .
```

#### Claude Settings (`claude_desktop_config.json`)
To use the MCP server correctly with Claude Desktop, you need to modify the claude_desktop_config.json file with appropriate values.
```
{
  "mcpServers": {
    "ros-general": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/ros-mcp",
        "run",
        "bash",
        "-c",
        "export ROS_LOG_DIR=/tmp && export ROS_DOMAIN_ID=${ROS_DOMAIN_ID:-YOUR_ROS_DOMAIN_ID} && source /opt/ros/humble/setup.bash && python3 /ABSOLUTE/PATH/TO/PARENT/FOLDER/ros-general.py"
      ]
    }
  }
}
```
##### **💡 Replace the following placeholders:**
- `/ABSOLUTE/PATH/TO/PARENT/FOLDER/ros-mcp`
Replace with the absolute path the ros-mcp directory. 
For example: /home/ubuntu/ros-mcp

- `YOUR_ROS_DOMAIN_ID`
  Replace with the ROS domain ID used in your environment to enable ROS communication between the MCP server and your local machine. If you're not sure what your current domain ID is, you can check it by running the following command in your terminal:
  ```bash
  echo $ROS_DOMAIN_ID
  ```
  If nothing is printed, the domain ID is not set, and the default value 0 will be used.
  Alternatively, you can set it manually using the following command:
  ```bash
  export ROS_DOMAIN_ID=10  # Replace 10 with your desired domain ID
  ```
- `/ABSOLUTE/PATH/TO/PARENT/FOLDER/ros-general.py`
Replace with the absolute path to your ros-general.py script.
For example: /home/ubuntu/ros-mcp/ros-general.py

## Running the Servers
#### Start MCP server
Make sure your virtual environment is activated before running the MCP server:
```bash
(ros-mcp) $ uv run ros-general.py
```
#### Start socket server
```bash
python3 socket_server.py
```
 > 💡not in the virtual environment!

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Yutarop](https://github.com/Yutarop)
- **Source:** [Yutarop/ros-mcp](https://github.com/Yutarop/ros-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-yutarop-ros-mcp
- Seller: https://agentstack.voostack.com/s/yutarop
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.