创世记 MCP 服务器

一个用于创世记世界模拟的模型上下文协议（MCP）服务器，支持可视化功能。

快速入门

要快速开始使用可视化功能：

# 运行简化的设置脚本（仅安装所需的组件）
./setup.sh

# 运行 stdio 客户端（打开一个可视化窗口）
./examples/stdio_client.py

这将直接启动创世记世界模拟，并通过 stdio 传输开始可视化。

传输方法：stdio

此服务器使用 stdio 传输，这是创世记世界可视化功能所必需的。 可视化组件需要本地运行时环境且无法通过网络传输工作。

安装配置

先决条件

• Python 3.8+
• uv 包管理器（pip install uv）
• npm（可选，用于 MCP 绝缘检测）

安装

Linux/macOS

# 克隆仓库
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp

# 运行设置脚本
./setup.sh

# 激活虚拟环境
source .venv/bin/activate

Windows

# 克隆仓库
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp

# 运行设置脚本
setup.bat

# 激活虚拟环境
.venv\Scripts\activate.bat

手动安装（使用 uv）

如果 preferring 手动安装依赖项：

1. 创建一个虚拟环境：

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

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

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

3. 安装 MCP 绝缘检测（可选）：

   npm install -g @modelcontextprotocol/inspector@0.6.0
   

运行服务器

# 使用 stdio 传输运行（可视化功能所必需）
./start.sh


### 使用 MCP 绝缘检测进行调试

要与 MCP 绝缘检测一起使用：

```bash
# 在一个终端中启动绝缘检测
mcp-inspector

# 在另一个终端中启动服务器并使用 stdio 传输
python server.py

配置绝缘检测如下：

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

可用信息资源

世界信息

获取创世记世界功能的信息：

world_info://{name}

可用工具

运行模拟

使用提供的代码和参数运行创世记世界模拟：

run_simulation

MCP 客户端

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

# 使用 Genesis World 可视化运行一个模拟
./examples/stdio_client.py

祝您愉快地使用！