What is Genesis Mcp

Genesis-MCP is a Model Context Protocol (MCP) server designed for simulations in Genesis World, providing visualization support for enhanced user interaction and experience.

Use cases

Use cases for Genesis-MCP include running interactive simulations in educational contexts, developing immersive gaming experiences, and creating virtual environments for training and research purposes.

How to use

To use Genesis-MCP, clone the repository, run the setup script to install necessary dependencies, and then start the server using the stdio transport method. For visualization, run the stdio client example provided in the repository.

Key features

Key features of Genesis-MCP include support for visualization through stdio transport, easy setup with scripts, and the ability to run simulations with the MCP Inspector for debugging and monitoring.

Where to use

Genesis-MCP can be used in various fields such as educational simulations, game development, virtual training environments, and any application requiring interactive simulation and visualization.

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:

1. Create a virtual environment:

   uv venv .venv
   source .venv/bin/activate  # Linux/macOS
   .venv\Scripts\activate.bat  # Windows
   

2. Install dependencies from lock file:

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

3. Install MCP Inspector (optional):

   npm install -g @modelcontextprotocol/[email protected]
   

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!