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

How are these scores calculated?

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-Guide
qpd-v
A
security
A
license
A
quality
A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
Last updated -
3
251
61
JavaScript
Apache 2.0
Mermaid MCP Server
longjianjiang
-
security
A
license
-
quality
A server that implements the Model Context Protocol (MCP), providing an interface for LLM applications to generate mermaid.js visualizations and diagrams.
Last updated -
Python
MIT License
Hello World MCP Server
jageenshukla
-
security
A
license
-
quality
A demonstration server that implements the Model Context Protocol (MCP) SDK, providing tools and endpoints for server-sent events and message handling.
Last updated -
41
7
TypeScript
MIT License
FastAPI MCP Server
purity3
-
security
A
license
-
quality
A high-performance Model Context Protocol (MCP) server designed for large language models, enabling real-time communication between AI models and applications with support for session management and intelligent tool registration.
Last updated -
2
Python
MIT License

View all related MCP servers

Genesis MCP Server