Genesis MCP 服务器

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

快速开始

要快速开始使用可视化功能，请执行以下步骤：

bash

运行简化设置脚本（仅安装必需项）

./setup.sh

运行 stdio 客户端（打开可视化窗口）

./examples/stdio_client.py

这将直接使用 stdio 传输方式启动带有可视化功能的 Genesis World 模拟。

传输方式：stdio

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

设置

前提条件

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

安装

Linux/macOS

bash

克隆仓库

git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp

运行设置脚本

./setup.sh

激活虚拟环境

source .venv/bin/activate

Windows

powershell

克隆仓库

git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp

运行设置脚本

setup.bat

激活虚拟环境

.venvScriptsactivate.bat

使用 uv 手动安装

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

1. 创建虚拟环境：

   bash
   uv venv .venv
   source .venv/bin/activate # Linux/macOS
   .venvScriptsactivate.bat # Windows

2. 从锁定文件安装依赖项：

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

3. 安装 MCP Inspector（可选）：
   bash
   npm install -g @modelcontextprotocol/inspector@0.6.0

运行服务器

bash

使用 stdio 传输方式运行（可视化所需）

./start.sh

与 MCP Inspector 一起使用

要使用 MCP Inspector 进行调试：

bash

在一个终端中，启动 inspector

mcp-inspector

在另一个终端中，使用 stdio 传输方式启动服务器

python server.py

配置 MCP Inspector：

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

可用资源

世界信息

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

world_info://{name}

可用工具

运行模拟

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

run_simulation

MCP 客户端

该仓库包含用于可视化的 stdio 客户端：

bash

使用 Genesis World 可视化运行模拟

./examples/stdio_client.py

祝您编程愉快！