Guild Wars 1 Build Compiler

gw1-mcp

LLM 向けの Guild Wars 1 ビルドコンパイラー

あらゆる互換性のある LLM クライアント（Claude、ChatGPT、Cursor…）に、 Guild Wars 1 のビルドに関する信頼性の高い、決定的な知識を提供する MCP（Model Context Protocol）サーバーです。スキルデータの検索、公式テンプレートコードのエンコード／デコード、ビルドの検証を行います。

この MCP はコンパイラーであり、頭脳ではありません。 戦略的な推論は LLM が行い、正確さが必須の処理はこのサーバーが担います。

LLM に尋ねるだけではだめなのでしょうか？

このサーバーを使わずに AI アシスタントへ Guild Wars のビルドを尋ねると、たいていは、もっともらしいものの実在しないスキルを含むスキルバー、ポイント上限を超える属性配分、10年前のバランス調整パッチの統計情報、そしてゲーム内に貼り付けると意味不明な内容にデコードされるテンプレートコードが返ってきます。コードはビット単位でパックされているため、文字ごとに幻覚で生成することはできません。

gw1-mcp を接続すると、同じアシスタントが実在する1516種類のスキル（Reforged のバランス調整に対応し、毎週更新）を検索し、実際のゲームルールに基づいてビルドを検証したうえで、言語モデルが予測したものではなく、エンコーダーが生成した公式テンプレートコードを提示します。戦略的な会話の質はアシスタントそのままに、事実の誤りを防げます。

ツール

• get_skill — 指定したスキル（正確な名前またはテンプレート ID）の全記録を取得し、誤入力の場合は最も近い候補を提示します。公式のフランス語のスキル名にも対応しています（Sceau de guérison → Healing Signet）。それ以外の名前フィールドは英語のみです
• search_skills — 職業、属性、キャンペーン、エリート、名前の部分一致で絞り込んで検索します
• decode_template — ゲーム内テンプレートコードを職業、属性、ステータス付きの 8 個のスキルに変換します
• encode_template — 名前付きビルドを検証し、公式のゲーム内テンプレートコードに変換します
• validate_build — GW1 のルールをチェックします：エリートスキルは最大 1 個、職業／属性の所有条件、プライマリ属性、重複
• get_hero — 正確な名前または GWCA ID でヒーローの記録を取得します
• list_heroes — 職業、キャンペーン、アンロックに関する注記を含むヒーロー一覧を取得します。職業／キャンペーンで絞り込み可能です
• decode_pawned_team — paw-ned2 のチームデータ（PvXwiki のチームページ）をデコードし、すべてのスキルバーを表示します

リソース：gw1://guide/build-workflow（LLM 向けの方法論）、gw1://meta（職業、属性ライン、キャンペーン、スキルタイプ一覧、データのインポート日）、gw1://heroes。

クイックスタート

pnpm install
pnpm -r test
pnpm --filter @gw1-mcp/gw-mcp dev   # stdio server

パッケージ

• packages/gw-template — テンプレートコードのコーデック（依存関係なし。ゲーム内／PvX コードとの往復テスト済みで、@buildwars/gw-templates と差分ファジング済み）
• packages/gw-data — build-wars/gw-skilldata からインポートしたゲームデータ（スキル 1516 個、Reforged 現行版）（コードは MIT ライセンス、スキルの説明は GFDL / CC BY-NC-SA ライセンスです。THIRD_PARTY_NOTICES.md をご覧ください）

コーデックは 4 つの方法で検証されています。全 10 種のプライマリ職業と全 5 キャンペーンを網羅した 27 件のゴールデンフィクスチャ（実際のゲーム内出力 9 件を含み、PvXwiki、gw1builds.com、公式 Wiki、2007 年以前のゲーム内形式から取得。一部はスキル ID レベルまで検証済み）、往復ファジング、独立した実装との差分テスト、不正な入力の拒否テストです。検証ルールは 1 つずつテーブルテストされています。数値については pnpm test:coverage を実行してください。

• packages/gw-mcp — MCP サーバー（トランスポートに依存しないコアと stdio エントリ）
• packages/gw-worker — Streamable HTTP ラッパー（Hono）。Cloudflare Workers と Node で実行できます

Cloudflare Workers へのデプロイ

pnpm --filter @gw1-mcp/gw-worker check    # offline bundling validation
pnpm --filter @gw1-mcp/gw-worker deploy   # needs `wrangler login` once

サーバーはステートレス（バンドル済みデータを使用し、リクエストごとに新しい McpServer を生成）なので、設定不要で Workers のモデルに適合します。Durable Objects、KV、シークレットは不要です。無料プランで十分です。

接続方法

• claude.ai / Claude アプリ：設定 → コネクタ → カスタムコネクタを追加 → https://gw1-mcp.<your-subdomain>.workers.dev/mcp
• Claude Code：claude mcp add --transport http gw1 https://…/mcp または stdio 経由でローカル接続：claude mcp add gw1 -- pnpm --filter @gw1-mcp/gw-mcp dev
• Cloudflare を使わないローカル HTTP：pnpm --filter @gw1-mcp/gw-worker dev:node を実行し、任意のクライアントから http://localhost:8787/mcp に接続します

ゲームデータの再生成

pnpm --filter @gw1-mcp/gw-data update @buildwars/gw-skilldata --latest
pnpm --filter @gw1-mcp/gw-data run import:data
# or, to import the upstream's published release files (what the weekly workflow does):
pnpm --filter @gw1-mcp/gw-data run import:data -- https://build-wars.github.io/gw-skilldata

GWToolbox との連携

gwtoolbox-plugin/ には、読み取り専用の GWToolbox プラグインが含まれており、/exportaccount を追加します。このコマンドはアカウントの状態を JSON としてクリップボードにコピーします。現在のキャラクター名も含まれるため、公開の場に貼り付ける前に内容を確認してください。エクスポートには 2 つのスキルリストがあります。learnedCharacterSkills（現在のキャラクターが実際に習得したスキル）と unlockedAccountSkills（ヒーロー用など、アカウント全体でアンロック済みのすべてのスキル）です。会話に貼り付け、作成するビルドに合ったリストを unlockedSkillIds として validate_build／encode_template に渡してください。キャラクターが装備するビルドには learnedCharacterSkills、ヒーローのスキルバーには unlockedAccountSkills を使用します。所有していないスキルの提案にはフラグが付けられます。Windows でのビルド手順は gwtoolbox-plugin/README.md をご覧ください。

ロードマップ

ビルドのアーキタイプとヒーローの制約、キャンペーンの進行状況に応じたヒーローの利用可否に関する MCP リソース、およびアカウントのエクスポート機能を GWToolbox 自体に取り込むことを予定しています。アーキテクチャに関する詳細なメモは CLAUDE.md を参照してください。

---

このプロジェクトは ArenaNet または NCSoft と提携していません。Guild Wars は NCSoft Corporation の商標です。ゲームデータは build-wars/gw-skilldata からインポートされています。コードは MIT ライセンスですが、スキルの説明文は Guild Wars コミュニティのウィキに由来し、GFDL および CC BY-NC-SA 2.5（非営利ライセンス）の対象です。詳しくは THIRD_PARTY_NOTICES.md を参照してください。フォーマットのドキュメントは Guild Wars Wiki を参照してください。

開発

pnpm install && pnpm -r test

Node >= 22、pnpm 11 が必要です。dist にビルドされるものはありません。エクスポートは .ts ソースを参照し、ワーカーは wrangler 経由でバンドルされます。開始方法については CONTRIBUTING.md を、アーキテクチャ、規約、既知の負債を率直に記載した一覧については CLAUDE.md を参照してください。

ライセンス

ソースコード：MIT（LICENSE を参照）。バンドルされたゲームデータには別途条件が適用されます。 THIRD_PARTY_NOTICES.md を参照してください。