Azeroth DB: WoW Forever

wowdb-mcp

通过 MCP stdio 从 Azeroth DB 读取 WoW Forever 记录。 按记录名称搜索，然后读取其值并打开对应的确切页面。

从源代码运行

需要 Node.js 26.12.1 或更高版本。

npm install
node server.mjs

该服务会将 MCP 消息写入 stdout。它不会启动 HTTP 侦听器、读取账户记录或更改站点数据。它不需要 API 密钥。

该站点也通过 Streamable HTTP 在 https://wowdb.wiki/api/mcp 提供相同的工具。wowdb-mcp 导出 createServer； wowdb-mcp/http 导出 handleMcp，后者处理一个无状态的 Streamable HTTP 请求，也是站点 /api/mcp 路由所运行的函数。

安装软件包

npm 尚未发布。若要在不将软件包添加为自身依赖项的情况下检查本地 tarball，请在安装依赖项后从此目录运行：

mkdir -p node_modules/.install-test
npm pack --pack-destination node_modules/.install-test
npm install --prefix node_modules/.install-test/prefix node_modules/.install-test/wowdb-mcp-0.2.1.tgz
node_modules/.install-test/prefix/node_modules/.bin/wowdb-mcp

此前缀可随时删除；关闭服务后，移除 node_modules/.install-test。发布前若要配置持久客户端，请按下文所述使用源代码可执行文件。

npm 发布后，请使用此客户端配置：

{
  "mcpServers": {
    "wowdb": {
      "command": "npx",
      "args": ["-y", "wowdb-mcp"]
    }
  }
}

在发布之前，请配置客户端运行 node，并将已安装软件包或源代码目录中的 server.mjs 绝对路径作为参数。

工具

工具	输入	结果
search	query；可选 kind、locale、offset、limit	匹配的名称及其类型、slug、页面路径和生产环境 URL
get_entity	搜索或列表结果中的 path；可选 field、offset、limit	实际记录数据、其表示形式、数据 URL 和生产环境页面 URL
list_entities	kind；可选 locale、offset、limit	按名称排序的记录，可通过 nextOffset 获取后续内容

支持的类型包括 item、recipe、ability、spell、enchant、talent、 legacy、race、quest、giver、camp、dungeon、achievement、faction 和英文 guide。该服务不提供新闻、玩家记录或地图放置工具。

{"name":"search","arguments":{"query":"Empty Vial","kind":"item","limit":1}}
{"name":"get_entity","arguments":{"path":"/forever/items/empty-vial"}}
{"name":"search","arguments":{"query":"Leere Phiole","kind":"item","locale":"deDE","limit":1}}
{"name":"get_entity","arguments":{"path":"/de/forever/gegenstaende/leere-phiole"}}

语言代码包括 enUS（默认）、deDE、esES、esMX、frFR、koKR、 ptBR、ruRU、zhCN 和 zhTW。搜索会读取所请求语言的索引；查询会根据返回的页面路径确定语言。请重复使用该路径，而不要翻译 slug 或添加 locale 查询参数。

数据边界

英文目录和具名记录 API 会为已发布的路径提供完整记录。搜索也涵盖只有预览 API 的记录。representation 为 full-record 或 preview，以便调用方区分这些响应。具名天赋从其职业响应中选出，而不是返回该职业本身。

本地化查询会返回站点的预览数据。这些响应可能使用英文字段标签、缩短关系列表或缺少文本。它们不会提供完整英文记录的所有字段。本地化指南记录没有查询 API，因此不包含在内。API 可能会描述高于 beta 等级上限的某个技能等级；此类预览会返回工具错误，而不会将该等级显示为 beta 技能。完整的英文技能响应会保留要求等级不高于 30 的等级，包括 API 明确将未知等级记录为 null 的情况。已知的物品要求等级和任务等级若高于 30，则不会纳入发现结果。

将 null 值和缺失字段视为未知。物品的存在并不能证明其掉落几率或获取条件。sellPrice 和 observed.price 等价格以铜币为单位；商人观察价格不是拍卖价格。每个成功结果都包含一个文本 content 块，其中含有序列化 JSON。HTTP 和查询失败会返回 isError: true 以及一条消息；记录缺失时会提示调用方重新搜索。

分页

limit 默认为 48，可接受 1 到 48，与网站公开的条目集合页面大小一致。搜索和列表结果会返回 nextOffset；使用相同的查询、类型和语言，将其作为 offset 传入。

查询会保留标量值和对象，并将每个数组限制为请求的页面大小。如果数组还有更多条目，pagination 会将其 field 标识为 JSON 指针，并提供 nextOffset。使用相同的页面路径，将这两个值传回 get_entity。例如：

{"name":"get_entity","arguments":{"path":"/forever/items/empty-vial","field":"/uses","offset":0,"limit":2}}

指针相对于返回的 data，例如 /ranks 或 /recipes/0/materials。它们会在数组分页前选择原始 API 数据。它们无法获取 API 本身未提供的关联数据。超出最后一条结果的偏移量会返回工具错误，而不会重复返回第一页。

测试来源

WOWDB_ORIGIN 是 API 请求唯一的环境变量覆盖项，例如 http://localhost:3712。它只会更改请求来源。返回的页面链接和数据链接仍指向 https://wowdb.wiki。

该软件包会读取自身公开的 API 合约。它不会导入网站源代码，不会将 API 负载存储到磁盘，也不会在调用之间保留语言索引。