Zero Parades database

zeroparadesdb-mcp

通过 MCP stdio 读取 zeroparadesdb.com 上的 ZERO PARADES: For Dead Spies 记录。需要 Node.js 22 或更高版本。公共请求无需账号或密钥。

工具

工具	输入与返回内容
lookup	输入 term，返回最匹配的记录，并附上规范页面 slug、URL 和预览信息。
search	输入 query，以及可选的 kind、page 和 locale，使用站点的搜索功能检索记录、检定和对话。结果包含稳定 ID、名称和规范页面 slug/URL。
get_record	输入 kind 和从搜索结果中获取的稳定 id，返回实际游戏字段、本地化页面内容和预览信息。
list_entities	输入 kind，以及可选的 page 和 locale，浏览已发布的页面内容，每页 50 条。继续请求，直到 nextPage 为 null。
planner_link	输入经过验证的思维 ID/阶段，以及可选的专注技能，生成预填的规划器 URL，不保存构筑。

locale 为可选项，默认为 en。其他值为 es-419、de、ru 和 zh-cn。get_record 和 list_entities 使用以下类型：

skill, item, character, task, thought, status-effect, achievement,
persona, progression-unit, district, waypoint, location,
interior-location, lore

搜索也涵盖检定和对话，以及编辑内容和工具页面。每页返回 50 条结果；使用其 pages 值，通过 page 继续查询。没有匹配项的查询会返回空结果。无效页面、未知记录或 HTTP 请求失败时，会返回包含易读文本的 MCP 工具错误。每个成功结果都会出现在 MCP 文本内容中。

读取记录值

查找时请使用稳定的 id，而不是页面 slug。Cold Read 的 ID 为 affect，英文页面 slug 为 cold-read。在德语中，同一记录的页面名称为 Cold Reading，slug 为 cold-reading。

即使请求使用了本地化语言，原始 fields 也可能包含英文名称和内部枚举标签。请使用 page.name、page.description 和 card 获取本地化文案。如果某种语言的 API 未发布该记录的页面，page 就会为 null；服务会保留 null，不会自行编造翻译或链接。

请将修正类型与其影响的字段分开看待。物品列表中的 cost 并不能确定对话交易中的支付价格，共同出现的角色也不一定是商人。服务只报告公共 API 暴露的信息。

{"name":"search","arguments":{"query":"Cold Read","kind":"skill"}}

{"name":"get_record","arguments":{"kind":"skill","id":"affect","locale":"de"}}

运行

在此目录中：

npm install
node src/server.mjs

npm 发布后，使用以下配置设置 MCP 客户端：

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

发布前，可使用 node 和 src/server.mjs 的绝对路径运行，或安装本地软件包 tarball 并使用其 zeroparadesdb-mcp 可执行文件。无需编译。

仅在测试其他 HTTP 源站时设置 ZEROPARADES_BASE。返回的页面链接仍使用生产环境的源站。普通客户端无需设置此变量。

许可证

MIT。详见 LICENSE。