Genesis MCP Server

What is Genesis MCP Server?

An MCP server for running Genesis World simulations with local visualization support. It uses stdio transport and is intended for users who need to run and visualize physics simulations interactively.

How to use Genesis MCP Server?

Clone the repository, run the setup script (setup.sh on Linux/macOS, setup.bat on Windows), activate the virtual environment, then start the server with ./start.sh or python server.py. Use the provided stdio client (./examples/stdio_client.py) to open a visualization window.

Key features of Genesis MCP Server

• Run Genesis World simulations via the run_simulation tool
• Retrieve world information through world_info://{name} resource
• Visualization requires stdio transport (no network transport supported)
• Provided stdio client for instant simulation with visualization
• Supports MCP Inspector for debugging with stdio transport
• Includes setup scripts for Linux/macOS and Windows

Use cases of Genesis MCP Server

• Running Genesis World physics simulations in a local environment
• Visualizing simulation output in real time
• Debugging MCP interactions using the MCP Inspector

FAQ from Genesis MCP Server

What transport method does the server use?

It uses stdio transport, which is required for Genesis World visualization features.

What are the runtime prerequisites?

Python 3.8+ and the uv package manager (pip install uv). npm is optional for using the MCP Inspector.

Can I use network transports for visualization?

No. The visualization components require a local runtime and cannot work over network transports.

How do I start a simulation with visualization?

Run ./examples/stdio_client.py from the repository directory after completing setup.

How do I install dependencies manually?

Run uv pip install -r requirements.lock, then uv pip install -e ., then uv pip install genesis==0.2.1 --no-deps.