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

祝您愉快地使用！