Genesis MCP

🚀 创世记 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）

如果您倾向于手动安装依赖项，可以按以下步骤操作：

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 绝缘检测一起使用，可按以下步骤操作：

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

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

配置绝缘检测如下：

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

高级用法

获取世界信息

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

world_info://{name}

运行模拟

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

run_simulation

运行 MCP 客户端

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

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

祝您愉快地使用！