Skip to main content
Glama

gazebo-mcp

Python 3.11+ Version License: MIT MCP MergeOS

gazebo-mcp is an MCP server so AI agents can drive Gazebo / gz-sim: worlds, models, poses, pause/step — with a full offline mock for CI and demos (no Gazebo install required).

Product: mergeos-bounties/gazebo-mcp


Highlights

Capability

Description

Offline mock

Seeded world + models; spawn/delete/pose without Gazebo

Live bridge

Optional HTTP/file bridge when GAZEBO_MCP_MODE=live

MCP stdio

Cursor / Claude / Grok host integration

CLI

demo · doctor · serve · call


Related MCP server: osracer-mcp

Quick start

cd gazebo-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
gazebo-mcp demo
gazebo-mcp doctor
pytest -q
gazebo-mcp serve

Modes

Mode

Env

Behavior

mock (default)

GAZEBO_MCP_MODE=mock

In-memory world graph

live

GAZEBO_MCP_MODE=live + bridge URL/file

Forwards to local Gazebo bridge


Tools

Tool

Purpose

gazebo_doctor

Connectivity / sim health

gazebo_seed_demo

Reset mock shapes world

gazebo_world_info

World name, paused, sim time

gazebo_list_models

Models in the world

gazebo_spawn / gazebo_delete

Model lifecycle

gazebo_set_pose / gazebo_get_pose

Pose control

gazebo_pause / gazebo_unpause / gazebo_step

Clock control


Examples


Development

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

MergeOS bounties

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


License

MIT · MergeOS / ThanhTrucSolutions

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

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/gazebo-mcp'

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