Servidor Genesis MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para simulaciones de Genesis World con soporte de visualización.

Inicio rápido

Para comenzar con la visualización de la forma más rápida:

# Run the simplified setup script (only installs what's needed)
./setup.sh

# Run the stdio client (opens a visualization window)
./examples/stdio_client.py

Esto iniciará directamente una simulación de Genesis World con visualización utilizando el transporte stdio.

Related MCP server: Hello World MCP Server

Método de transporte: stdio

Este servidor utiliza el transporte stdio , necesario para las funciones de visualización de Genesis World. Los componentes de visualización requieren un entorno de ejecución local y no pueden funcionar con transportes de red.

Configuración

Prerrequisitos

• Python 3.8+

• Gestor de paquetes uv ( pip install uv )

• npm (opcional, para MCP Inspector)

Instalación

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

Ventanas

# 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

Instalación manual con uv

Si prefiere instalar las dependencias manualmente:

1. Crear un entorno virtual:

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

2. Instalar dependencias desde el archivo de bloqueo:

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

3. Instalar MCP Inspector (opcional):

   npm install -g @modelcontextprotocol/inspector@0.6.0

Ejecución del servidor

# 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 el Inspector MCP con:

• Tipo de transporte: STDIO

• Comando: python

• Argumentos: server.py

Recursos disponibles

Información mundial

Obtenga información sobre las características de Genesis World:

world_info://{name}

Herramientas disponibles

Simulación de ejecución

Ejecute una simulación de Genesis World con el código y los parámetros proporcionados:

run_simulation

Cliente MCP

El repositorio incluye el cliente stdio para visualización:

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

¡Feliz hackeo!