mergeos-bounties/ros2-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

12 stars 29 forks Качество 83 Тренд 23MIT

Repository Install

ros2-mcp — MCP server for AI agents to inspect and control ROS2

Обзор

is an MCP (Model Context Protocol) server so AI agents (Grok, Cursor, Claude, …) can graphs — topics, nodes, services, TF, actions — without hand-writing every ros2 CLI call. This installs the (ros2-mcp) and the (skill + MCP server from .mcp.json). After pip install "git+https://github.com/mergeos-bounties/ros2-mcp.git", point any MCP host at: — merge examples/claude_desktop_config.json into Claude MCP config. All packages speak (ros2-mcp serve). Default mode is (offline, no simulator/terminal/GIMP required). All packages ship with as the default. Parameter names and value: " " so MCP host transcripts and CI logs do not accidentally capture runtime configuration. Use ROS2_MCP_MODE=live only when a live ROS2 graph is available. Build a ROS2 Humble image with ros2-mcp installed into an isolated Python environment: Serve MCP over stdio from the container:

README

Показан фрагмент оригинального README. Открыть оригинал.

ros2-mcp

ros2-mcp is an MCP (Model Context Protocol) server so AI agents (Grok, Cursor, Claude, …) can inspect and control ROS2 graphs — topics, nodes, services, TF, actions — without hand-writing every ros2 CLI call.

Product: mergeos-bounties/ros2-mcp

Install (one command)

Grok — recommended

pip install "git+https://github.com/mergeos-bounties/ros2-mcp.git" && grok plugin install mergeos-bounties/ros2-mcp --trust

This installs the Python CLI (ros2-mcp) and the Grok plugin (skill + MCP server from .mcp.json).

Check:

ros2-mcp version
ros2-mcp doctor
ros2-mcp demo
grok plugin list
grok mcp list

Local clone:

git clone https://github.com/mergeos-bounties/ros2-mcp.git
cd ros2-mcp
pip install -e ".[dev]"
grok plugin install . --trust

Other agents (stdio MCP)

After pip install "git+https://github.com/mergeos-bounties/ros2-mcp.git", point any MCP host at:

Field	Value
command	`ros2-mcp`
args	`["serve"]`
env	`ROS2_MCP_MODE=mock`

Claude Desktop — merge examples/claude_desktop_config.json into Claude MCP config.

Cursor — merge examples/cursor_mcp.json.

Grok config.toml (manual, without plugin):

[mcp_servers.ros2_mcp]
command = "ros2-mcp"
args = ["serve"]
env = { ROS2_MCP_MODE = "mock" }

Or one-shot:

pip install "git+https://github.com/mergeos-bounties/ros2-mcp.git"
grok mcp add ros2-mcp -- ros2-mcp serve

Supported AI agents / hosts

Agent / Host	MCP support	Setup
Grok (CLI / TUI / Build)	Yes	`grok plugin install mergeos-bounties/ros2-mcp --trust` then `pip install "git+https://github.com/mergeos-bounties/ros2-mcp.git"`
Claude Desktop	Yes	Copy examples/claude_desktop_config.json into Claude MCP settings
Cursor	Yes	Merge examples/cursor_mcp.json into Cursor MCP config
Claude Code	Yes	stdio MCP: same `command`/`args` as Claude Desktop / Grok
VS Code (MCP / Continue / Cline)	Yes	Generic stdio server config pointing at `ros2-mcp serve`
Windsurf / Cascade	Yes	stdio MCP entry with `ros2-mcp` + `serve`

Открыть полный README на GitHub

Установка

docker run --rm ros2-mcp:humble demo

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "ros2-mcp": {
      "command": "ros2-mcp",
      "args": ["serve"],
      "env": {
        "ROS2_MCP_MODE": "mock"
      }
    }
  }
}