Genesis MCP Server

Genesis MCP 服务

用于 Genesis World 仿真的 Model Context Protocol（MCP）服务，支持可视化。

快速开始

使用可视化功能快速上手：

# Run the simplified setup script (only installs what's needed)
./setup.sh

# Run the stdio client (opens a visualization window)
./examples/stdio_client.py

这将通过 stdio 传输直接启动带可视化功能的 Genesis World 仿真。

传输方式：stdio

此服务使用 stdio 传输，这是 Genesis World 可视化功能的必要条件。 可视化组件需要本地运行时，无法通过网络传输方式运行。

设置

先决条件

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

安装

Linux/macOS

# Clone the repository
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp

# Run the setup script
./setup.sh

# Activate the virtual environment
source .venv/bin/activate

Windows

# Clone the repository
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp

# Run the setup script
setup.bat

# Activate the virtual environment
.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/[email protected]
   

运行服务

# Run with stdio transport (required for visualization)
./start.sh


### Using with the MCP Inspector

To use with the MCP Inspector for debugging:

```bash
# In one terminal, start the inspector
mcp-inspector

# In another terminal, start the server with stdio transport
python server.py

使用以下配置设置 MCP Inspector：

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

可用资源

世界信息

获取 Genesis World 功能的信息：

world_info://{name}

可用工具

运行仿真

使用提供的代码和参数运行 Genesis World 仿真：

run_simulation

MCP 客户端

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

# Run a simulation with Genesis World visualization
./examples/stdio_client.py

祝你开发愉快！