Guild Wars 1 Build Compiler

gw1-mcp

面向大模型的《Guild Wars 1》配装编译器

一个 MCP（Model Context Protocol）服务，为所有兼容的大模型客户端 （Claude、ChatGPT、Cursor……）提供关于 Guild Wars 1 配装的可靠、确定性知识：技能数据查询、官方模板代码编解码，以及配装验证。

MCP 是编译器，不是大脑。 大模型负责战略推理；此服务负责必须精确无误的事务。

为什么不直接问大模型？

如果不使用此服务，直接向 AI 助手询问《Guild Wars》配装，你通常会得到：一个听起来合理、却包含不存在技能的技能栏；超出点数预算的属性分配；来自十年前平衡补丁的数据；以及一段粘贴到游戏中会解码成乱码的模板代码——因为代码采用位打包，无法逐字符凭空猜出来。

连接 gw1-mcp 后，同一个助手会查询 1516 个真实技能（与 Reforged 平衡版本保持同步，每周更新），根据实际游戏规则验证配装，并提供由编码器生成的官方模板代码，而非由语言模型预测的代码。战略对话的质量丝毫不变；事实不再出错。

工具

• get_skill — 按精确名称或模板 ID 获取单个技能的完整记录，并在名称拼写错误时提供最接近的匹配建议。官方法语技能名称也可解析（Sceau de guérison → Healing Signet）；其他名称字段仅支持英文
• search_skills — 按职业、属性、战役、精英技能和名称子字符串筛选搜索
• decode_template — 将游戏内模板代码解码为职业、属性以及含属性数据的 8 个技能
• encode_template — 将具名配置转换为经过验证的官方游戏内模板代码
• validate_build — GW1 规则检查：最多一个精英技能、职业／属性归属、主属性、重复项
• 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 — 游戏数据（1516 个技能，当前 Reforged 版本），导入自 build-wars/gw-skilldata（代码采用 MIT 许可；技能说明采用 GFDL / CC BY-NC-SA 许可——参见 THIRD_PARTY_NOTICES.md）

该编解码器通过四种方式验证：27 个黄金测试样例（包括 9 个游戏内实时生成的数据），覆盖全部 10 个主职业和全部 5 个战役（来源包括 PvXwiki、gw1builds.com、官方 wiki 和 2007 年以前的游戏内格式，其中多个样例已验证到技能 ID 级别）；模糊往返测试；与独立实现的差分测试；以及对格式错误输入的拒绝测试。验证规则逐条通过表格测试。查看测试数据请运行 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 格式复制到剪贴板——其中 包含你当前角色的名称，因此粘贴到公开场所之前请先查看内容。该导出 包含两个技能列表——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 社区 Wiki，并遵循 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 源文件，Worker 则通过 wrangler 打包。请参阅 CONTRIBUTING.md 开始使用，并参阅 CLAUDE.md 了解完整架构、约定以及已知问题的真实清单。

许可证

源代码：MIT（请参阅 LICENSE）。随附的游戏数据遵循单独的条款—— 请参阅 THIRD_PARTY_NOTICES.md。