【技术文档摘要】： <img src="imgs/big_text.png" alt="Genesis" width="200" />

Genesis MCP 服务器

用于 Genesis 世界模拟的 Model Context Protocol (MCP) 服务器，并支持可视化功能。

快速开始

快速启动可视化的最简单方法：

# 运行简化安装脚本（仅安装所需内容）
./setup.sh

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

这将直接使用标准 I/O 传输启动带有可视化的 Genesis 世界模拟。

传输方式：标准 I/O

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

安装

先决条件

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

安装

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 手动安装

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

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 Inspector（可选）：

   npm install -g @modelcontextprotocol/inspector@0.6.0
   

运行服务器

# 使用标准 I/O 传输运行（可视化所需）
./start.sh


### 使用 MCP Inspector

要与 MCP Inspector 结合使用进行调试：

```bash
# 在一个终端中启动 inspector
mcp-inspector

# 在另一个终端中使用标准 I/O 传输启动服务器
python server.py

配置 MCP Inspector：

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

可用资源

世界信息

获取关于 Genesis 世界特性的信息：

world_info://{name}

可用工具

运行模拟

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

run_simulation

MCP 客户端

该仓库包括用于可视化的标准 I/O 客户端：

# 运行带有 Genesis 世界可视化的模拟
./examples/stdio_client.py

祝您编程愉快！