Waldzell Metagames Server

🚀 Waldzell Metagames MCP Server

このサーバーは、ゲーム理論に基づくワークフローと問題解決フレームワークの包括的なライブラリへのアクセスを提供するModel Context Protocol (MCP) サーバーです。これらのメタゲームは、分析麻痺、完璧主義のスパイラル、スコープクリープなどの一般的な落とし穴を回避し、ソフトウェア開発、プロジェクト管理、オペレーションズリサーチの課題に対する体系的なアプローチを提供します。

🚀 クイックスタート

Waldzell Metagamesサーバーは、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: バグをランク付けされた仮説に変換します。
  • 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: 段階的な納期管理をStage-Gate/DMAIC原則で行います。
• リソース割り当て
  • knapsack-sprint: ナップサック問題の最適化を使用した迅速な割り当てを行います。
  • queue-triage: 待ち時間とサービス利用率のバランスを取ります。
• 実行
  • ooda-loop-sprint: OODA、PDCA、Lean Startupを組み合わせた迅速な反復を行います。

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: 新しいメタゲームを作成するための標準構造を提供します。

💻 使用例

基本的な使用法

すべてのメタゲームをリストする

// 利用可能なすべてのメタゲームをリストする
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での使用例

# 基本的な使用法
refactoring gameを使用してsrc/ディレクトリを改善する

# パラメータ付き
最新のPRに対して、厳密な時間制限でcode review gameを実行する

# 探索
技術的負債を解消するためのメタゲームはありますか？

# 特定の複雑度
初心者レベルのプロジェクト管理メタゲームを表示する

📚 ドキュメント

メタゲームの構造

各メタゲームは一貫した構造に従っています。

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ファイルを参照してください。

🙏 謝辞

このプロジェクトは、ガラス珠ゲームのヴァルツェル（Waldzell）にちなんで名付けられました。ヴァルツェルは、構造化された制約の中で無限の可能性の空間を探求する形式的なゲームが行われる場所です。

🛠️ サポート

• 問題報告: GitHub Issues
• 議論: GitHub Discussions
• ドキュメント: Wiki