Which integrations are available for this server?

Provides tools for controlling RViz2 displays, fixed frames, and views, enabling AI agents to interact with ROS visualization.

How do I use rviz-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@rviz-mcp add a RobotModel display" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

rviz-mcp

by mergeos-bounties

Overview Schema Related Servers Score Discussions

Python

Local

rviz-mcp

Python 3.11+ Version License: MIT MCP MergeOS

rviz-mcp is an MCP server so AI agents can control RViz2 displays, fixed frames, and views — with a full offline mock for CI and demos (no ROS/RViz install required).

Product: mergeos-bounties/rviz-mcp

Install (one command)

Grok — recommended

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

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

Check:

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

Local clone:

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

Other agents (stdio MCP)

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

Field	Value
command	`rviz-mcp`
args	`["serve"]`
env	`RVIZ_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.rviz_mcp]
command = "rviz-mcp"
args = ["serve"]
env = { RVIZ_MCP_MODE = "mock" }
enabled = true

One-liner via Grok CLI:

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

Related MCP server: ROS 2 MCP Server

Supported AI agents / hosts

Host	Support	Install
Grok (CLI / TUI / Build)	Yes	`grok plugin install mergeos-bounties/rviz-mcp --trust` then `pip install "git+https://github.com/mergeos-bounties/rviz-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 `rviz-mcp serve`
Windsurf / Cascade	Yes	stdio MCP entry with `rviz-mcp` + `serve`
Codex CLI	Yes (stdio)	Register MCP server command `rviz-mcp serve` in Codex MCP settings
ChatGPT Desktop	Partial	Only if host supports custom MCP stdio servers
Gemini CLI	Partial	Only if MCP stdio plugins are enabled

All packages speak MCP over stdio (rviz-mcp serve). Default mode is mock (offline, no simulator/terminal/GIMP required).

Highlights

Capability	Description
Offline mock	Display tree, fixed frame, view controller
Live bridge	Optional HTTP/file bridge when `RVIZ_MCP_MODE=live`
MCP stdio	Cursor / Claude / Grok host integration
CLI	`status` · `demo` · `doctor` · `serve` · `call`

Quick start

cd rviz-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
rviz-mcp demo
rviz-mcp demo --profile nav
rviz-mcp doctor
rviz-mcp status
pytest -q

rviz-mcp serve

Modes

Mode	Env	Behavior
mock (default)	`RVIZ_MCP_MODE=mock`	In-memory RViz config
live	`RVIZ_MCP_MODE=live` + bridge URL/file	Forwards to local RViz bridge

Tools

Tool	Purpose
`rviz_doctor`	Connectivity / config health
`status` (CLI)	Fixed frame, display count, mode, version (`--json` supported)
`rviz_seed_demo`	Reset mock displays (Grid, TF, RobotModel)
`rviz_list_displays`	Current display tree
`rviz_add_display` / `rviz_remove_display`	Manage displays
`rviz_list_panels`	Current panel layout
`rviz_add_panel` / `rviz_remove_panel`	Manage mock UI panels
`rviz_set_fixed_frame`	Fixed frame (e.g. `map`, `odom`)
`rviz_set_view`	View controller type + look-at
`rviz_load_config` / `rviz_save_config`	Config path (mock records path)
`rviz_screenshot`	Mock screenshot path

Mock display graph quickstart

Run a full mock RViz2 display tree without RViz2 installed — useful for CI, documentation screenshots, and agent demos.

# 1. Seed the default display tree (Grid + TF + RobotModel)
rviz-mcp demo

# 2. Inspect the mock config
rviz-mcp status --json

# 3. Export the full config snapshot for agents
rviz-mcp export-config

# 4. Run against the MCP server (Cursor / Claude / Grok)
rviz-mcp serve
# Then query the rviz://config resource

# Non-PowerShell (bash / zsh)
python -m rviz_mcp demo
python -m rviz_mcp status --json
python -m rviz_mcp export-config
python -m rviz_mcp serve

The display graph includes class names, topics, and enable state — every field an agent needs to understand or replicate the layout.

Demo profiles

The default mock seed includes Grid, TF, and RobotModel. The navigation profile adds Map, LaserScan, and GlobalPath displays for nav-stack demos:

rviz-mcp demo --profile nav

Resources

URI	Purpose
`rviz://config`	Read-only snapshot of the current config: `fixed_frame`, `view`, `displays` (with `display_count`), `panels`, and `config_path`. Served from the mock display tree offline.

Example payload:

{
  "ok": true,
  "mode": "mock",
  "fixed_frame": "map",
  "view": { "class": "rviz_default_plugins/Orbit", "distance": 10.0 },
  "displays": [
    { "name": "Grid", "class": "rviz_default_plugins/Grid", "enabled": true, "topic": "" }
  ],
  "display_count": 3,
  "panels": [
    { "class": "rviz_common/Displays", "name": "Displays", "dock": "left", "visible": true },
    { "class": "rviz_common/Views", "name": "Views", "dock": "right", "visible": true },
    { "class": "rviz_common/Time", "name": "Time", "dock": "bottom", "visible": true }
  ],
  "config_path": "mock://default.rviz"
}

Examples

examples/cursor_mcp.json
examples/claude_desktop_config.json
docs/LIVE_BRIDGE.md for live bridge load_config and screenshot endpoints

Development

ruff check src tests
pytest -q
rviz-mcp tools list

MergeOS bounties

Star → claim issue → PR to master → MRG 25–200.
See mergeos.

License

MIT · MergeOS / ThanhTrucSolutions

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

bumi-mcp
Autonomous Agents AI & Machine Learning Image & Video Processing
sandraschi
A
license
A
quality
B
maintenance
MCP server for controlling the Noetix Bumi humanoid robot via ROS 2, with support for autonomous mission planning using LLMs and computer vision.
Updated 4 days ago (2026-08-06 12:27 UTC)
2
6
MIT
ROS 2 MCP Server
Command Line Developer Tools Shell Access
Ranch-Hand-Robotics
A
license
-
quality
D
maintenance
A Model Context Protocol server for ROS 2, enabling AI assistants to introspect and interact with ROS 2 systems.
Updated 6 months ago (2026-01-25 21:26 UTC)
2
MIT
ros2-mcp
Developer Tools Command Line AI & Machine Learning
mergeos-bounties
A
license
-
quality
B
maintenance
MCP server for AI agents to inspect and control ROS2 graphs, enabling topic listing, node info, service calls, parameter management, and pub/echo without manual ROS2 CLI usage.
Updated 19 days ago (2026-07-22 07:13 UTC)
9
MIT
gazebo-mcp
Developer Tools Autonomous Agents
mergeos-bounties
A
license
-
quality
A
maintenance
MCP server for AI agents to drive Gazebo / gz-sim simulation, with offline mock mode for CI/demos.
Updated 19 days ago (2026-07-22 06:51 UTC)
4
MIT

View all related MCP servers

Related MCP Connectors

microservices.sh
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
ChiR24-unreal_mcp_server
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
hithereiamaliff-mcp-nextcloud
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mergeos-bounties/rviz-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

rviz-mcp

Install (one command)

Grok — recommended

Other agents (stdio MCP)

Supported AI agents / hosts

Highlights

Quick start

Modes

Tools

Mock display graph quickstart

Demo profiles

Resources

Examples

Development

MergeOS bounties

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

bumi-mcp

ROS 2 MCP Server

ros2-mcp

gazebo-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API