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