Zero Parades database

zeroparadesdb-mcp

MCP stdio を介して、zeroparadesdb.com から ZERO PARADES: For Dead Spies の記録を読み取ります。Node.js 22 以降が必要です。公開リクエストにアカウントやキーは必要ありません。

ツール

ツール	入力と回答
lookup	term を指定すると、一致度の高い記録と、正式なページスラッグ、URL、プレビュー情報が返されます。
search	query と、任意の kind、page、locale を指定すると、サイト内の記録、チェック、会話を検索できます。結果には安定した ID、名前、正式なページスラッグ／URL が含まれます。
get_record	検索結果の kind と安定した id を指定すると、実際のゲーム内フィールド、ローカライズされたページ表示、プレビュー情報が返されます。
list_entities	kind と、任意の page、locale を指定すると、公開済みのページ表示を1ページあたり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

検索では、編集ページやツールページに加えて、チェックや会話も対象になります。1ページあたり50件の結果が返されます。pages の値を確認し、page を指定して続きを取得してください。一致する結果がないクエリでは、空の結果が返されます。無効なページ、未知の記録、HTTP リクエストの失敗は、読み取り可能なテキストを含む MCP ツールエラーとして返されます。成功した結果はすべて MCP のテキストコンテンツに含まれます。

記録の値を読み取る

検索にはページスラッグではなく、安定した id を使用してください。Cold Read の ID は affect で、英語のページスラッグは cold-read です。ドイツ語では、同じ記録のページ名は Cold Reading、スラッグは cold-reading です。

ローカライズされたリクエストでも、生の fields に英語の名前や内部の列挙ラベルが含まれる場合があります。ローカライズされた表記には、page.name、page.description、card を使用してください。page が null の場合、その言語では API に該当する記録のページが公開されていません。サーバーは翻訳やリンクを捏造せず、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 を参照してください。