https://github.com/dustland/genesis-mcp
MCP Server for Genesis World.
https://github.com/dustland/genesis-mcp
genesis mcp simulation
Last synced: 6 months ago
JSON representation
MCP Server for Genesis World.
- Host: GitHub
- URL: https://github.com/dustland/genesis-mcp
- Owner: dustland
- License: mit
- Created: 2025-03-19T16:39:28.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-19T18:06:57.000Z (7 months ago)
- Last Synced: 2025-03-19T19:23:52.995Z (7 months ago)
- Topics: genesis, mcp, simulation
- Language: Python
- Homepage:
- Size: 364 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Genesis MCP - An MCP server bridging AI assistants with Genesis World simulations, enabling customizable agent-based virtual world simulations and behavior analysis within conversations. ([Read more](/details/genesis-mcp.md)) `mcp` `simulation` `ai-integration` `virtual-world` (AI Integration MCP Servers)
- mcp-index - Genesis - Run immersive simulations in the Genesis World with advanced visualization capabilities, enabling dynamic environments and interactions through a user-friendly interface. (Developer Tools)
README
# 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:
```bash
# 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
```bash
# 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
```powershell
# 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:
```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
```
## Running the Server
````bash
# 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!