Igdb MCP Server

🚀 IGDB MCP Server

IGDB MCP Serverは、Model Context Protocol (MCP) を通じて、Internet Game Database (IGDB) APIにアクセスできるようにします。

🚀 クイックスタート

IGDBの認証情報を取得する

1. Twitchアカウントを作成します（まだ持っていない場合）
2. Twitch Developer Consoleにアクセスし、「Register Your Application」を選択します
3. Client ID を取得し、Client Secret を生成します

📖 IGDBの完全な認証ガイド

オプションA: Smitheryを通じてインストールする

Smitheryを通じて、igdb-mcp-serverを自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @bielacki/igdb-mcp-server

オプションB: uvxでインストールする

uvをインストールします。

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"
      }
    }
  }
}

✨ 主な機能

IGDB MCP Serverは、Model Context Protocolを通じて、Internet Game Database (IGDB) にシームレスにアクセスできるようにします。IGDBは、ビデオゲームに関する情報を含む包括的なデータベースで、以下のような情報が含まれています。

• ゲームのメタデータ（タイトル、説明、評価）
• リリース日とプラットフォーム
• 開発者とパブリッシャーの情報
• ジャンル、テーマ、ゲームモード
• ユーザー評価とハイプ指標
• 表紙画像とメディア

主要な機能

• 完全なIGDB APIアクセス: ゲームを検索し、詳細情報を取得し、トレンドのタイトルを見つけることができます
• スマートキャッシュ: OAuthトークンがキャッシュされ、認証のオーバーヘッドを最小限に抑えます
• 柔軟なクエリ: 単純な検索または高度なApicalypseクエリ言語を使用できます
• 事前構築されたプロンプト: 一般的なクエリがすぐに使用できます
• 型安全: Pydanticを使用して構築され、強力なデータ検証が行われます

💻 使用例

基本的な使用法

以下の例を使って、IGDB MCP Serverを探索し始めましょう。

🔍 検索と発見

• "Search for Elden Ring and its expansions"
• "Find all Persona games from the last 5 years"
• "Show me games similar to Hades"

📊 ゲーム情報

• "Get details about Baldur's Gate 3"
• "Tell me everything about Cyberpunk 2077 including DLC"
• "What platforms is Hogwarts Legacy available on?"

🔥 トレンドと人気

• "What are the most anticipated upcoming games?"
• "Show me the highest rated indie games of 2024"
• "Find games with the most hype right now"

🎯 高度なクエリ

• "Find games similar to Skyrim with a rating of 85 or higher"
• "List all games by Larian Studios"
• "Show upcoming Silent Hill and Resident Evil games"

📚 ドキュメント

ツール

リソース

事前構築されたプロンプト

トラブルシューティング

認証エラー

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

レート制限

IGDBは1秒あたり4回のリクエストを許可しています。サーバーはレート制限を実装していないため、以下のことを行ってください。

• 繰り返しの迅速なクエリを避ける
• 複数のリクエストの代わりに、フィールド拡張を使用する
• バッチ操作にマルチクエリを利用する

一般的なクエリの問題

• No results: スペルを確認し、より広範な検索用語を試してみてください
• Missing fields: 一部のフィールドはnullになる場合があります。適切に処理してください
• Query syntax error: Apicalypse構文を確認し、セミコロンをチェックしてください

環境変数

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

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

📄 ライセンス

MITライセンス - 詳細については、LICENSEファイルを参照してください

クレジット:

• IGDB.comによるIGDB API
• AnthropicによるMCPプロトコル
• FastMCPで構築
• Smitheryで公開

IGDB APIの機能に関する詳細情報については、公式IGDB APIドキュメントをご覧ください。