Genesis World

by dustland

2 stars

415 downloads

Not rated

GitHub

About

Bridges AI assistants with Genesis World simulations, enabling execution of customizable agent-based simulations and virtual world creation for analyzing emergent behaviors directly within conversations.

Details

Author: dustland
Repository: dustland/genesis-mcp
GitHub stars: 2
Downloads: 415
License: MIT License
Categories: Productivity, Design, Developer Tools, AI, Frontend, Knowledge Base, Infrastructure, Other
Tags: #integration

- Run Genesis World simulations via the run_simulation tool
- Retrieve world information through world_info://{name} resource
- Visualization requires stdio transport (no network transport supported)
- Provided stdio client for instant simulation with visualization
- Supports MCP Inspector for debugging with stdio transport
- Includes setup scripts for Linux/macOS and Windows

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Genesis World

Command (node, npx, python, etc.) python
Arguments
- Argument 1 server.py
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv\\Scripts\\activate.bat",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv\\Scripts\\activate.bat",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv\\Scripts\\activate.bat",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv\\Scripts\\activate.bat",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv\\Scripts\\activate.bat",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

From the repository

./setup.sh

setup.bat

.venv\Scripts\activate.bat

If you prefer to install dependencies manually: 1. Create a virtual environment:

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

2. Install dependencies from lock file:

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



3. Install MCP Inspector (optional):

bash
npm install -g @modelcontextprotocol/inspector@0.6.0

`bash

`run_simulation`

Run a Genesis World simulation with provided code and parameters.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "genesis world": {
            "cwd": ".venv/bin/activate",
            "env": {},
            "args": [
                "server.py"
            ],
            "command": "python"
        }
    }
}

Linux

{
    "cwd": ".venv/bin/activate",
    "env": [],
    "args": [
        "server.py"
    ],
    "command": "python"
}

Macos

{
    "cwd": ".venv/bin/activate",
    "env": [],
    "args": [
        "server.py"
    ],
    "command": "python"
}

Windows

{
    "cwd": ".venv\\Scripts\\activate.bat",
    "env": [],
    "args": [
        "server.py"
    ],
    "command": "python"
}

Genesis

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/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:

bash

Run a simulation with Genesis World visualization

./examples/stdio_client.py
```

Happy hacking!

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

run_simulation

Claude Desktop / Cursor

Linux

Macos

Windows

Genesis MCP Server

Quick Start

Run the stdio client (opens a visualization window)

Transport Method: stdio

Setup

Prerequisites

Installation

Linux/macOS

Run the setup script

Activate the virtual environment

Windows

Run the setup script

Activate the virtual environment

Manual Installation with uv

Running the Server

Using with the MCP Inspector

In one terminal, start the inspector

In another terminal, start the server with stdio transport

Available Resources

World Info

Available Tools

Run Simulation

MCP Client

Run a simulation with Genesis World visualization

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`run_simulation`