Universe Game MCP Server

Universe Game MCP 服务

增强版康威生命游戏模拟器，以 MCP（Model Context Protocol）服务的形式运行，供 Claude Desktop 使用。观看细胞自动机不断演化，欣赏精美的 ASCII 可视化效果、图案检测和详细分析！

❗这个游戏会消耗大量 token。增加回合数时请务必谨慎。❗

你可以在这里查看游戏过程： https://claude.ai/share/a7dde4b2-be5c-4c17-9bfd-32e4137e6500

功能

• 🌌 康威生命游戏模拟：在 20x20 网格上运行经典细胞自动机
• 🎨 精美的 ASCII 可视化效果：每 10 回合显示详细画面和统计数据
• 🔍 图案检测：自动检测振荡器、静物和滑翔机
• 📊 实时分析：人口跟踪、出生/死亡统计和稳定性分析
• 🎮 交互式控制：手动操控细胞和插入图案
• 🚀 预置图案：添加滑翔机、闪烁器、方块和信标等经典图案

面向非技术用户的快速入门

前提条件

你需要在电脑上安装 Python。以下是检查和安装方法：

Windows

1. 打开命令提示符（按 Win + R，输入 cmd，按 Enter）
2. 输入 python --version 并按 Enter
3. 如果看到版本号（例如 Python 3.11.0），就可以继续了！
4. 如果没有，请从 python.org 下载并安装 Python
   • ⚠️ 重要提示：安装时勾选“Add Python to PATH”

Mac

1. 打开终端（按 Cmd + Space，输入“Terminal”，按 Enter）
2. 输入 python3 --version 并按 Enter
3. 如果看到版本号，就可以继续了！
4. 如果没有，请从 python.org 安装 Python，或使用 Homebrew：

   brew install python
   

安装步骤

1. 下载游戏

   • 将此仓库下载或克隆到电脑上
   • 如果下载的是 ZIP 文件，请解压
   • 记下文件夹路径（稍后会用到）

2. 安装所需库

   Windows：

   pip install numpy
   

   Mac：

   pip3 install numpy
   

3. 配置 Claude Desktop

   找到 Claude Desktop 配置文件：

   Windows： %APPDATA%\Claude\claude_desktop_config.json

   Mac： ~/Library/Application Support/Claude/claude_desktop_config.json

   用文本编辑器打开该文件，并添加服务配置：

   Windows 配置：

   {
       "mcpServers": {
           "universe_game": {
               "command": "python",
               "args": ["C:\\path\\to\\your\\universe_game.py"],
               "env": {}
           }
       }
   }
   

   Mac 配置：

   {
       "mcpServers": {
           "universe_game": {
               "command": "python3",
               "args": ["/path/to/your/universe_game.py"],
               "env": {}
           }
       }
   }
   

   请将路径替换为文件的实际位置！

   示例路径：

   • Windows："C:\\Users\\YourName\\Downloads\\universe_game\\universe_game.py"
   • Mac："/Users/YourName/Downloads/universe_game/universe_game.py"

4. 重启 Claude Desktop

   • 完全关闭 Claude Desktop
   • 重新打开
   • 现在应该可以使用 Universe Game 了！

使用方法

配置完成后，你可以通过 Claude 与 Universe Game 互动。以下是可用命令：

基本命令

• 开始演化：让 Claude“推进宇宙”或“推进模拟”
• 查看状态：询问“宇宙状态”或“当前状态”
• 重置游戏：请求“重置宇宙”

高级功能

• 手动控制细胞：“翻转位置 (5, 7) 的细胞”
• 添加图案：“添加一个滑翔机图案”或“在 (10, 10) 放置一个闪烁器”
• 获取分析数据：使用“显示宇宙分析”查看详细统计数据

对话示例

You: "Let's start the universe game!"
Claude: [Initializes and shows the current state]

You: "Step the universe forward 5 times"
Claude: [Advances simulation and shows evolution]

You: "Add a glider pattern and let it run"
Claude: [Places glider and shows it moving across the grid]

You: "What patterns have been detected?"
Claude: [Shows analytics with detected oscillators, still lifes, etc.]

了解显示内容

游戏会显示一个 20x20 网格，其中：

• # = 活细胞
• . 或 = 死细胞

每 10 回合，你都会看到详细显示内容，包括：

• 🌌 带坐标的宇宙网格
• 📊 人口统计数据
• 💫 生命强度条
• 图案检测结果

故障排除

常见问题

“Command not found” 错误：

• Windows：确保已安装 Python 并将其添加到 PATH
• Mac：尝试在配置中使用 python3 而不是 python

“Module not found” 错误：

• 安装 numpy：pip install numpy（Windows）或 pip3 install numpy（Mac）

“File not found” 错误：

• 仔细检查配置中的文件路径
• Mac 使用正斜杠 /，Windows 使用反斜杠 \\
• 确保指定位置存在该文件

配置不起作用：

• 验证 JSON 语法是否正确（可使用在线 JSON 验证器）
• 修改后重启 Claude Desktop
• 检查文件路径是否包含特殊字符

获取帮助

如果遇到问题：

1. 检查是否已正确安装 Python 和 numpy
2. 验证文件路径是否正确
3. 确保配置后已重启 Claude Desktop
4. 尝试直接运行 Python 文件进行测试：python universe_game.py

技术细节

系统要求

• Python 3.7+
• numpy 库
• Claude Desktop 应用程序

架构

• 构建为 MCP（模型上下文协议）服务
• 实现康威生命游戏规则
• 具备模式检测算法
• 提供实时统计数据和可视化

文件结构

universe_game/
├── universe_game.py          # Main MCP server
├── README.md                 # This file
└── examples/                 # Example patterns (optional)

贡献

欢迎贡献改进、错误修复或新功能：

1. Fork 仓库
2. 创建功能分支
3. 提交拉取请求

许可证

本项目为开源项目。可根据需要自由使用、修改和分发。

致谢

• 基于 John Conway 的生命游戏
• 为 Claude Desktop MCP 生态系统构建
• 灵感来自元胞自动机研究与可视化

---

Claude Desktop https://claude.ai/download