Genesis MCP 服务器

用于 Genesis World 模拟的模型上下文协议 (MCP) 服务器，具有可视化支持。

快速入门

开始可视化的最快方法：

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

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

这将直接启动使用 stdio 传输进行可视化的 Genesis World 模拟。

传输方法：stdio

此服务器使用stdio 传输，这是 Genesis World 可视化功能所必需的。可视化组件需要本地运行时，无法通过网络传输运行。

设置

先决条件

Python 3.8+
uv 包管理器（ pip install uv ）
npm（可选，用于 MCP Inspector）

安装

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

视窗

# 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

使用 uv 手动安装

如果您希望手动安装依赖项：

创建虚拟环境：
uv venv .venv source .venv/bin/activate # Linux/macOS .venv\Scripts\activate.bat # Windows
从锁文件安装依赖项：
uv pip install -r requirements.lock uv pip install -e . uv pip install genesis==0.2.1 --no-deps
安装 MCP Inspector（可选）：
npm install -g @modelcontextprotocol/inspector@0.6.0

运行服务器

# 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

使用以下配置配置 MCP 检查器：

传输类型：STDIO
命令：python
参数：server.py

可用资源

世界信息

获取有关 Genesis World 功能的信息：

world_info://{name}

可用工具

运行模拟

使用提供的代码和参数运行 Genesis World 模拟：

run_simulation

MCP 客户端

该存储库包括用于可视化的 stdio 客户端：

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

祝您黑客愉快！

Genesis MCP Server

Integrations