Genesis MCP

🚀 Genesis MCP Server

A Model Context Protocol (MCP) server for Genesis world simulation, supporting visualization features.

🚀 Quick Start

To quickly start using the visualization feature:

# Run the simplified setup script (install only the required components)
./setup.sh

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

This will directly start the Genesis world simulation and initiate visualization via stdio transmission.

✨ Features

Transmission Method: stdio

This server uses stdio transmission, which is essential for the Genesis world visualization feature. The visualization component requires a local runtime environment and cannot work via network transmission.

📦 Installation

Prerequisites

• Python 3.8+
• uv package manager (pip install uv)
• npm (optional, for MCP insulation detection)

Installation Steps

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 (Using uv)

If you prefer manual installation of dependencies:

1. Create a virtual environment:

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

2. Install dependencies from the lock file:

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

3. Install MCP insulation detection (optional):

   npm install -g @modelcontextprotocol/inspector@0.6.0
   

💻 Usage Examples

Running the Server

# Run using stdio transmission (essential for visualization)
./start.sh

Debugging with MCP Insulation Detection

To use with MCP insulation detection:

# Start the insulation detection in one terminal
mcp-inspector

# Start the server in another terminal and use stdio transmission
python server.py

Configure the insulation detection as follows:

• Transmission type: STDIO
• Command: python
• Parameters: server.py

Available Information Resources

World Information

Get information about Genesis world features:

world_info://{name}

Available Tools

Run Simulation

Run a Genesis world simulation using the provided code and parameters:

run_simulation

MCP Client

This repository contains a stdio client for visualization:

# Run a simulation with Genesis World visualization
./examples/stdio_client.py

Enjoy using it!