waldzell-metagames-server

🚀 瓦尔茨尔元游戏MCP服务器

这是一个模型上下文协议（MCP）服务器，提供对丰富的博弈论工作流和问题解决框架库的访问。这些元游戏有助于避免常见的陷阱，如分析瘫痪、完美主义循环和范围蔓延，同时为软件开发、项目管理和运筹学挑战提供系统的解决方案。

🚀 快速开始

瓦尔茨尔元游戏服务器提供27种以上结构化的问题解决框架，分为6大类，每个框架都旨在将开放性挑战转化为具有明确决策点和终止条件的系统性、限时工作流。

📦 安装指南

# 克隆仓库
git clone https://github.com/yourusername/waldzell-metagames-server.git
cd waldzell-metagames-server

# 安装依赖
npm install

# 构建服务器
npm run build

📚 详细文档

配置

将以下内容添加到您的MCP客户端配置中：

{
  "mcpServers": {
    "waldzell-metagames": {
      "command": "node",
      "args": ["/path/to/waldzell-metagames-server/dist/index.js"]
    }
  }
}

对于Claude Desktop，将其添加到 ~/Library/Application Support/Claude/claude_desktop_config.json。

元游戏类别

1. 软件开发

重点：代码质量、测试、文档和架构

• 代码质量
  • code-review-game：基于博弈论的代码审查，避免陷入无关紧要的讨论
  • refactoring-game：系统性重构，避免陷入完美主义循环
• 调试与测试
  • debugging-hypothesis-to-spec-game：将bug转化为排序后的假设
  • sandbox-testing-mechanism：在隔离的E2B沙箱中测试代码
• 文档
  • docs-improvement-game：发现API差距并发布生产文档
  • docs-verification-game：确保文档与实现一致
• 架构
  • complexity-navigator：分解和管理系统复杂性

2. 产品开发

重点：功能构思、实现和创新

• 构思
  • feature-discovery：生成多样化的实现方案，避免陷入第一想法陷阱
  • idea-to-specs-protocol：将想法转化为精心策划的规格说明
• 实现
  • feature-implementation-game：运用运筹学启发的风险最小化方法交付功能
• 创新
  • virgil-protocol：运用维吉尔·阿布洛（Virgil Abloh）的3%规则进行有目的的创新

3. 项目管理

重点：规划、资源分配和执行

• 规划
  • critical-path-quest：找出控制交付时间的任务
  • stage-gate-sentinel：采用阶段门/DMAIC原则进行分阶段交付
• 资源分配
  • knapsack-sprint：使用背包优化算法进行快速资源分配
  • queue-triage：平衡等待时间和服务利用率
• 执行
  • ooda-loop-sprint：结合OODA、PDCA和精益创业方法进行快速迭代

4. 运筹学

重点：优化、约束和不确定性

• 约束分析
  • bottleneck-blitz：通过约束理论优化吞吐量
  • shadow-price-showdown：使用对偶分析评估约束价值
• 多目标
  • pareto-pursuit：揭示帕累托前沿的权衡
• 风险与不确定性
  • monte-carlo-mandate：通过随机模拟比较策略
  • sensitivity-sweep：对计划假设进行压力测试

5. MCP生态系统

重点：MCP服务器开发和质量保证

• 服务器开发
  • mcp-server-implementation-game：端到端实现和验证MCP服务器
• 质量保证
  • mcp-dogfood：对MCP服务器进行全面的内部测试

6. 元学习与框架

重点：学习系统和知识提取

• 学习系统
  • learning-accelerator：优化命令系统随时间的学习方式
• 知识提取
  • wisdom-distillation：从战术实现中提取战略原则
• 协议
  • ulysses-protocol：高风险调试，防止无休止的迭代
• 模板
  • metagame-template：创建新元游戏的标准结构

API使用方法

列出所有元游戏

// 列出所有可用的元游戏
await mcp.call('listMetagames', {});

// 以层次树形式列出
await mcp.call('listMetagames', { format: 'tree' });

过滤元游戏

// 按类别过滤
await mcp.call('listMetagames', { 
  category: 'software-development' 
});

// 按复杂度过滤
await mcp.call('listMetagames', { 
  complexity: 'intermediate' 
});

// 按子类别过滤
await mcp.call('listMetagames', { 
  category: 'project-management',
  subcategory: 'planning' 
});

获取特定元游戏

// 获取元游戏内容
await mcp.call('getMetagame', { 
  name: 'refactoring-game' 
});

// 获取带有元数据的元游戏
await mcp.call('getMetagame', { 
  name: 'refactoring-game',
  includeMetadata: true 
});

通过资源访问

// 列出所有元游戏资源
const resources = await mcp.listResources();

// 读取特定元游戏资源
const content = await mcp.readResource('metagame://refactoring-game');

在Claude中的使用示例

# 基本用法
使用重构游戏改进src/目录

# 带参数
对最新的PR运行代码审查游戏，并严格限时

# 探索
哪些元游戏可以帮助解决技术债务问题？

# 特定复杂度
展示初级项目管理元游戏

元游戏结构

每个元游戏都遵循一致的结构：

1. 问题陈述：它要解决的挑战
2. 阶段：具有明确目标的限时阶段
3. 决策点：明确的继续/停止决策点
4. 终止条件：何时停止（防止陷入循环）
5. 成功指标：如何衡量有效性
6. 反模式：要避免的常见陷阱

开发

添加新元游戏

1. 在适当的类别文件夹中创建Markdown文件
2. 将元数据添加到子类别对应的 metadata.json 文件中
3. 遵循元游戏模板结构
4. 根据模式进行验证：npm run validate

目录结构

src/resources/metagames/
├── categories.json              # 类别定义
├── metagame-schema.json        # 验证模式
├── 01-software-development/
│   ├── code-quality/
│   │   ├── *.md               # 元游戏文件
│   │   └── metadata.json      # 子类别元数据
│   └── ...
└── ...

构建和测试

# 构建服务器
npm run build

# 运行测试
npm test

# 验证元游戏模式
npm run validate

# 开发模式
npm run dev

贡献代码

1. 分叉仓库
2. 创建功能分支 (git checkout -b feature/new-metagame)
3. 按照模板结构添加元游戏
4. 在 metadata.json 中更新元游戏详细信息
5. 提交拉取请求，并描述它解决的问题

设计理念

这些元游戏体现了以下领域的原则：

• 博弈论：纳什均衡、机制设计、拍卖理论
• 运筹学：线性规划、排队论、优化
• 软件工程：敏捷开发、DevOps、测试驱动开发
• 系统思维：反馈循环、约束、涌现

目标是将无边界的问题转化为系统性的工作流，在避免常见失败模式的同时交付成果。

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。

🙏 致谢

本项目以《玻璃球游戏》中的瓦尔茨尔命名，在那里，正式的游戏在结构化的约束内探索无限的可能性空间。

🛠️ 支持

• 问题反馈：GitHub Issues
• 讨论交流：GitHub Discussions
• 文档资料：Wiki