home / mcp / genesis mcp server

Genesis MCP Server

MCP Server for Genesis World.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "dustland-genesis-mcp": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

You run an MCP server to connect visualization clients and tooling to Genesis World simulations using a local stdio transport. This setup allows you to visualize and interact with live simulations directly from your development environment, enabling quick iteration and debugging.

How to use

You will use a local stdio MCP server with a Python-based runtime to drive Genesis World simulations and visualization. Start the MCP server with the stdio transport, then run a visualization client to connect to it. For debugging and inspection, you can also run the MCP Inspector alongside the server.

How to install

Prerequisites you need before installing the MCP server:

Python 3.8+
uv package manager (install with pip install uv)
npm (optional, for MCP Inspector)

Choose one of the installation paths below and follow the steps in order.

# Linux/macOS: clone the project and set up
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp

# Run the setup script to install required components
./setup.sh

# Activate the virtual environment
source .venv/bin/activate

Additional setup and running notes

The server communicates using stdio transport, which is required for Genesis World visualization features. Visualization components rely on a local runtime and do not work over network transports.

To run the MCP Inspector for debugging, you can start the inspector in one terminal and then start the server with stdio transport in another.

# Start the MCP Inspector in one terminal
mcp-inspector

# Start the server with stdio transport in another terminal
python server.py

Available resources

Get information about Genesis World features using the World Info resource:

world_info://{name}

Available actions

Trigger actions and simulations using predefined tools and commands. You can run a Genesis World simulation with provided code and parameters.

run_simulation

MCP Client and visualization

The repository includes a stdio client for visualization. Use it to run a simulation with Genesis World visualization connected through stdio.

./examples/stdio_client.py

Quick start example

# Run the simplified setup (only installs what's needed)
./setup.sh

# Run the stdio client to open a visualization window
./examples/stdio_client.py

Available tools

Run Simulation

Executes a Genesis World simulation using the provided code and parameters.

World Info

Requests information about Genesis World features and capabilities via the world_info resource.

stdio_client

Client utility that connects to the MCP server using stdio to render a visualization of the simulation.