<img src="imgs/big_text.png" alt="Genesis" width="200" />

Genesis MCP 服务器

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

快速开始

使用可视化功能的最快方式：

# 运行简化的安装脚本（仅安装所需内容）
./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

# 克隆仓库
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. 从 lock 文件安装依赖项：

   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
   

运行服务器

# 使用 stdio 传输运行（可视化需要）
./start.sh


### 与 MCP Inspector 一起使用

要与 MCP Inspector 一起用于调试：

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

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

使用以下配置 MCP Inspector：

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

可用资源

World Info

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

world_info://{name}

可用工具

Run Simulation

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

run_simulation

MCP 客户端

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

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

祝您编程愉快！