What is Genesis World MCP Server?
Genesis World MCP Server is a server designed for running simulations in Genesis World using the Model Context Protocol (MCP). It allows AI agents to generate and execute simulation code through a standardized protocol.
How to use Genesis World MCP Server?
To use the server, clone the repository, install the necessary dependencies, and start the server using Python or the MCP CLI. You can then send requests to run simulations or get world information.
Key features of Genesis World MCP Server?
- MCP endpoint for executing Genesis World simulations
- Access to simulation capabilities of Genesis World
- Self-documenting API that exposes features of Genesis World
- Example simulations provided for quick start
- MCP CLI integration for easy management of the server
Use cases of Genesis World MCP Server?
- Running complex simulations in Genesis World.
- Integrating AI agents to interact with simulation environments.
- Testing and developing simulation code in a controlled environment.
FAQ from Genesis World MCP Server?
- What is the Model Context Protocol (MCP)?
MCP is a protocol that standardizes the way AI agents can interact with simulation environments.
- How do I install the server?
You can install it using a lock file or manually resolving dependency conflicts as described in the documentation.
- Can I run multiple simulations at once?
Yes, the server can handle multiple requests, allowing for concurrent simulations.
Genesis MCP Server
A Model Context Protocol (MCP) server for Genesis World simulations with visualization support.
Quick Start
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.
Transport Method: stdio
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.
Setup
Prerequisites
- Python 3.8+
- uv package manager (
pip install uv) - npm (optional, for MCP Inspector)
Installation
Linux/macOS
# 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
Windows
# 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
Manual Installation with uv
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
Running the Server
# 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:
- Transport Type: STDIO
- Command: python
- Arguments: server.py
Available Resources
World Info
Get information about Genesis World features:
world_info://{name}
Available Tools
Run Simulation
Run a Genesis World simulation with provided code and parameters:
run_simulation
MCP Client
The repository includes stdio client for visualization:
# Run a simulation with Genesis World visualization
./examples/stdio_client.py
Happy hacking!
