bielacki-igdb-mcp-server

IGDB MCP サーバー

Model Context Protocol（MCP）を通じて IGDB（Internet Game Database）API にアクセスします

概要

IGDB MCP サーバーを使うと、Model Context Protocol を通じて Internet Game Database（IGDB）にシームレスにアクセスできます。IGDB は、以下のようなビデオゲームに関する情報を網羅したデータベースです。

• ゲームのメタデータ（タイトル、説明、評価）
• 発売日とプラットフォーム
• 開発元および販売元の情報
• ジャンル、テーマ、ゲームモード
• ユーザー評価と注目度指標
• カバーアートとメディア

主な機能

• IGDB API への完全なアクセス：ゲームの検索、詳細情報の取得、注目タイトルの確認
• スマートキャッシュ：OAuth トークンをキャッシュして、認証にかかるオーバーヘッドを最小限に抑えます
• 柔軟なクエリ：シンプルな検索や高度な Apicalypse クエリ言語を利用できます
• 事前作成済みプロンプト：よく使われるクエリをすぐに利用できます
• 型安全：堅牢なデータ検証のために Pydantic を使って構築されています

クイックスタート

前提条件

• uv がインストールされていること
• MCP 対応クライアント（Claude Desktop、Cursor、Copilot など）

IGDB 認証情報の取得

1. Twitch アカウントを作成します（まだ持っていない場合）
2. Twitch Developer Console にアクセスし、アプリケーションを登録します
3. Client ID を取得し、Client Secret を生成します

📖 IGDB 認証ガイド全文

MCP クライアントの設定

以下を MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "igdb-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/bielacki/igdb-mcp-server.git", "igdb-mcp-server"],
      "env": {
        "IGDB_CLIENT_ID": "your_client_id",
        "IGDB_CLIENT_SECRET": "your_secret"
      }
    }
  }
}

探索を始める

次のプロンプトを使って、探索を始めましょう。

🔍 検索と探索

• 「Elden Ring とその拡張版を検索して」
• 「過去 5 年間の Persona ゲームをすべて探して」
• 「Hades に似たゲームを表示して」

📊 ゲーム情報

• 「Baldur's Gate 3 の詳細を取得して」
• 「DLC を含めて Cyberpunk 2077 についてすべて教えて」
• 「Hogwarts Legacy はどのプラットフォームで遊べる？」

🔥 注目作と人気作

• 「今後発売予定のゲームで最も期待されているものは？」
• 「2024 年に最も評価の高かったインディーゲームを表示して」
• 「現在、最も注目されているゲームを探して」

🎯 高度なクエリ

• 「Skyrim に似ていて、評価が 85 以上のゲームを探して」
• 「Larian Studios のゲームをすべて一覧表示して」
• 「今後発売予定の Silent Hill と Resident Evil のゲームを表示して」

主なコンポーネント

ツール

ツール	説明	パラメーター	使用例
search_games	名前でゲームを検索します	• query（必須）：検索語 • fields：返すフィールド（デフォルト：基本情報） • limit：結果数（1～500、デフォルト：10）	「Elden Ring のゲームを検索して」
get_game_details	ゲームの包括的な情報を取得します	• game_id（必須）：IGDB のゲーム ID • fields：返すフィールド（デフォルト：詳細情報）	「ゲーム ID 1942 の詳細を取得して」
get_most_anticipated_games	注目度を基に今後発売予定のゲームを探します	• fields：返すフィールド • limit：結果数（1～500、デフォルト：25） • min_hypes：注目度の最小数（デフォルト：25）	「最も期待されているゲームを表示して」
custom_query	Apicalypse クエリを実行します	• endpoint（必須）：API エンドポイント • query（必須）：Apicalypse クエリ文字列	「評価が 90 を超える RPG を探して」

リソース

リソース	説明	返される内容
igdb://endpoints	IGDB API のすべてのエンドポイントの一覧	説明付きの利用可能なエンドポイント
igdb://query-syntax	Apicalypse クエリ言語ガイド	構文リファレンスと例

組み込みプロンプト

プロンプト	説明	用途
search_game	書式を整えたゲーム検索結果	すっきりした出力で手早くゲームを見つける
game_details	包括的なゲーム情報	評価、プラットフォーム、開発元を含む詳細情報
most_anticipated	話題の発売予定ゲーム	統計情報を使って期待の未発売ゲームを見つける

トラブルシューティング

認証エラー

• "IGDB_CLIENT_ID not set"：MCP クライアントの設定に環境変数が含まれていることを確認してください
• "Invalid credentials"：Client ID と Secret が正しいことを確認してください
• "Token expired"：サーバーがトークンを自動的に更新します

レート制限

IGDB では、1 秒あたり 4 件のリクエストが許可されています。サーバーはレート制限を実装していないため、次の点に注意してください。

• 短時間に同じクエリを繰り返さないでください
• 複数回のリクエストの代わりにフィールドの展開を使用してください
• バッチ処理には複数クエリを活用してください

よくあるクエリの問題

• 結果がない：スペルを確認し、より広い検索語を試してください
• フィールドが不足している：一部のフィールドは null の場合があります。適切に処理してください
• クエリ構文エラー：Apicalypse の構文を確認し、セミコロンをチェックしてください

環境変数

MCP クライアントの設定に以下が含まれていることを確認してください。

"env": {
  "IGDB_CLIENT_ID": "abc123...",
  "IGDB_CLIENT_SECRET": "xyz789..."
}

ライセンスとクレジット

MIT License - 詳細は LICENSE ファイルをご覧ください

クレジット：

• IGDB API：IGDB.com 提供
• MCP プロトコル：Anthropic 提供
• FastMCP で構築

---

IGDB API の機能について詳しくは、公式の IGDB API ドキュメントをご覧ください。