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!

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol (MCP) server for running Genesis World simulations with integrated visualization support, using stdio transport to enable local runtime visualization features.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-vegalite-server
isaacwasserman
-
security
F
license
-
quality
A Model Context Protocol (MCP) server implementation that provides the LLM an interface for visualizing data using Vega-Lite syntax.
Last updated -
65
Python
Calculator MCP Server
QuantGeekDev
-
security
F
license
-
quality
A Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.
Last updated -
48
4
TypeScript
MCP Maker
CaptainCrouton89
-
security
-
license
-
quality
A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
Last updated -
1
TypeScript
Claude Figma MCP
tonycueva
-
security
F
license
-
quality
A Model Context Protocol (MCP) server that enables Claude to create and manipulate designs in Figma through either a Figma plugin or directly via the Figma API.
Last updated -
TypeScript

View all related MCP servers

Genesis MCP Server