Glama
Sign In

Genesis MCP Server

by dustland
Verified
GitHub
Python
MIT License
  • Linux
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

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

Integrations

  • Enables cloning of repositories from GitHub, used for retrieving the MCP server codebase.

  • Provides OS-level support for running Genesis World simulations with specific setup instructions.

  • Provides OS-level support for running Genesis World simulations with specific setup instructions.

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:

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

Happy hacking!

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

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

  1. Quick Start
    1. Transport Method: stdio
      1. Setup
        1. Prerequisites
        2. Installation
        3. Manual Installation with uv
      2. Running the Server
        1. Available Resources
          1. World Info
        2. Available Tools
          1. Run Simulation
        3. MCP Client

          Related Resources