Dustland/genesis-mcp
Built by Metorial, the integration platform for agentic AI.
Dustland/genesis-mcp
Server Summary
Run simulations
Visualize dynamic environments
Interact with simulation elements
Streamlined setup process
A Model Context Protocol (MCP) server for Genesis World simulations with visualization support.
For the fastest way to get started with visualization:
# Run the simplified setup script (only installs what's needed)
./setup.sh
# Run the stdio client (opens a visualization window)
./examples/stdio_client.py
This will directly start a Genesis World simulation with visualization using stdio transport.
This server uses stdio transport which is required for Genesis World visualization features. The visualization components require a local runtime and cannot work over network transports.
pip install uv
)# Clone the repository
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp
# Run the setup script
./setup.sh
# Activate the virtual environment
source .venv/bin/activate
# Clone the repository
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp
# Run the setup script
setup.bat
# Activate the virtual environment
.venv\Scripts\activate.bat
If you prefer to install dependencies manually:
Create a virtual environment:
uv venv .venv
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate.bat # Windows
Install dependencies from lock file:
uv pip install -r requirements.lock
uv pip install -e .
uv pip install genesis==0.2.1 --no-deps
Install MCP Inspector (optional):
npm install -g @modelcontextprotocol/inspector@0.6.0
# Run with stdio transport (required for visualization)
./start.sh
### Using with the MCP Inspector
To use with the MCP Inspector for debugging:
```bash
# In one terminal, start the inspector
mcp-inspector
# In another terminal, start the server with stdio transport
python server.py
Configure the MCP Inspector with:
Get information about Genesis World features:
world_info://{name}
Run a Genesis World simulation with provided code and parameters:
run_simulation
The repository includes stdio client for visualization:
# Run a simulation with Genesis World visualization
./examples/stdio_client.py
Happy hacking!