Igdb

@pipeworx/igdb

IGDB（Internet Game Database、Twitch/Amazon）は、約30万本のビデオゲームを収録した基準カタログです。プラットフォームごとの発売日、ジャンル、評価、開発元、パブリッシャー、シリーズ、カバーアートを確認できます。

Pipeworx の一部です。AI エージェントを1881以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式インテグレーションであり、上流プロバイダーとの提携、承認、または公開はありません。

ツール

• igdb_search_games(query) — タイトルでゲームを検索します。必要に応じて、プラットフォームまたは発売時期で絞り込めます。
• igdb_game(id | slug) — 1つのゲームの詳細情報を返します。プラットフォームごとの発売日、DLC、拡張版、類似タイトルを含みます。
• igdb_companies(query) — 開発元とパブリッシャー、およびそれらがリリースした作品を検索します。
• igdb_platforms(query) — 約200のプラットフォームを検索します。プラットフォームのIDでゲーム検索を絞り込めます。

認証

プラットフォームキー（PLATFORM_TWITCH_KEY）を使用します。_apiKey で独自のキーに差し替えることもできます。

認証情報は twitch パックで使うものと同じTwitchアプリのものです。IGDBはTwitch OAuthで保護されているため、_apiKey に "CLIENT_ID:CLIENT_SECRET" を指定すると、パックが呼び出しごとにアプリのアクセストークンと交換します。このパックのために新しいゲートウェイバインディングは追加されておらず、既存の PLATFORM_TWITCH_KEY を宣言しています。

独自のレート制限枠を使いたい場合は、https://dev.twitch.tv/console から無料で認証情報を取得できます。

データソース

• https://id.twitch.tv/oauth2/token — クライアント認証情報グラント。
• https://api.igdb.com/v4/games、/companies、/platforms — POST、Apicalypse形式のボディ。

あとから使う人が調べ直さずに済むよう、注意点を記します。

• APIはPOSTのみで、ボディはJSONではなくDSLです。 fields name,summary; search "zelda"; limit 10; — すべての節の末尾にセミコロンが必要です。
• fields は必須です。省略するとエラーではなく空のオブジェクトが返されます。 これがこのAPI特有の、気づきにくい空結果の落とし穴です。このパックでは必ず明示的にフィールド一覧を送信します。
• 同じクエリに search と sort を指定することはできません。 search "x" は関連度順で、where name ~ *"x"* は並べ替え可能な部分文字列フィルターです。ゲームと会社のツールでは前者を、igdb_platforms では後者を使います。
• first_release_date と start_date は文字列ではなくUnix秒です。日付はすべてISO形式の日付としても返されます。
• カバー画像やロゴの image_id 値は、次の形式のURLに変換されます。 https://images.igdb.com/igdb/image/upload/<size>/<image_id>.jpg
• IGDBのゲームIDとTwitchのゲームIDは同じID空間を共有しているため、このパックは twitch と組み合わせて使えます。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "igdb": {
      "url": "https://gateway.pipeworx.io/igdb/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/igdb/mcp の tools/list は、上の表にあるツールに加えて、共通のPipeworxメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、共通ツールが約30個表示されます。接続の initialize 応答には正確な範囲が記載されており、その日付時点での正式な情報となります。

これは意図的な設計であり、偶然の多重化ではありません。パックの範囲外の質問にも、カタログ全体に振り分ける ask_pipeworx を通じて回答できるのが、メタツールの役割です。MCPサーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントに接続する方法はありません。追加スキーマがもたらすコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworxのフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと1881以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を通じてすべてのツールにアクセスできます。

MCP クライアントがありませんか？ HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/igdb_search_games \
  -H 'Content-Type: application/json' \
  -d '{"query":"Breath of the Wild","limit":5}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/igdb_search_games を実行してください。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行してください。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、Pipeworx アカウントやゲートウェイへの往復通信が不要な、ローカルの stdio MCP サーバーとしても実行できます。

{
  "mcpServers": {
    "igdb": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-igdb"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-igdb

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Igdb data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT