Genesis MCP 服务器
用于 Genesis World 模拟的模型上下文协议 (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
视窗
# 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 手动安装
如果您希望手动安装依赖项：
- 创建虚拟环境：
uv venv .venv
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate.bat # Windows
- 从锁文件安装依赖项：
uv pip install -r requirements.lock
uv pip install -e .
uv pip install genesis==0.2.1 --no-deps
- 安装 MCP Inspector（可选）：
npm install -g @modelcontextprotocol/inspector@0.6.0
运行服务器
# 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 检查器：
- 传输类型：STDIO
- 命令：python
- 参数：server.py
可用资源
世界信息
获取有关 Genesis World 功能的信息：
可用工具
运行模拟
使用提供的代码和参数运行 Genesis World 模拟：
MCP 客户端
该存储库包括用于可视化的 stdio 客户端：
# Run a simulation with Genesis World visualization
./examples/stdio_client.py
祝您黑客愉快！