Igdb MCP Server

🚀 IGDB MCP Server

IGDB MCP Server 允許你通過模型上下文協議（MCP）訪問互聯網遊戲數據庫（IGDB）API，為你提供豐富的遊戲信息查詢服務。

🚀 快速開始

獲取 IGDB 憑證

1. 如果你還沒有 Twitch 賬戶，請創建一個 Twitch 賬戶。
2. 訪問 Twitch 開發者控制檯，註冊你的應用程序。
3. 獲取你的 客戶端 ID 並生成一個 客戶端密鑰。

📖 完整的 IGDB 身份驗證指南

選項 A：通過 Smithery 安裝

要通過 Smithery 自動安裝 igdb - mcp - server，請運行以下命令：

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

選項 B：使用 uvx 安裝

1. 安裝 uv。
2. 將以下內容添加到你的 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"
      }
    }
  }
}

開始探索

使用以下示例提示開始探索： 🔍 搜索與發現

• "搜索《艾爾登法環》及其擴展內容"
• "查找過去 5 年發佈的所有《女神異聞錄》系列遊戲"
• "展示與《哈迪斯》類似的遊戲"

📊 遊戲信息

• "獲取《博德之門 3》的詳細信息"
• "告訴我關於《賽博朋克 2077》的所有信息，包括 DLC"
• "《霍格沃茨之遺》在哪些平臺上可用？"

🔥 熱門與流行

• "哪些是最受期待的即將推出的遊戲？"
• "展示 2024 年評分最高的獨立遊戲"
• "查找當前最受關注的遊戲"

🎯 高級查詢

• "查找與《上古卷軸 5：天際》類似且評分在 85 分以上的遊戲"
• "列出拉瑞安工作室開發的所有遊戲"
• "展示即將推出的《寂靜嶺》和《生化危機》系列遊戲"

✨ 主要特性

• 全面的 IGDB API 訪問：可搜索遊戲、獲取詳細信息、查找熱門遊戲。
• 智能緩存：對 OAuth 令牌進行緩存，以減少身份驗證開銷。
• 靈活查詢：支持簡單搜索或使用高級 Apicalypse 查詢語言。
• 預構建提示：提供常用查詢，隨時可用。
• 類型安全：使用 Pydantic 構建，確保數據驗證的健壯性。

🔧 技術細節

核心組件

工具

資源

預構建提示

📚 詳細文檔

故障排除

身份驗證錯誤

• “IGDB_CLIENT_ID 未設置”：檢查你的 MCP 客戶端配置中是否包含環境變量。
• “無效憑證”：驗證你的客戶端 ID 和密鑰是否正確。
• “令牌過期”：服務器會自動處理令牌刷新。

速率限制

IGDB 允許每秒 4 個請求。由於服務器未實現速率限制，請：

• 避免快速重複查詢。
• 使用字段擴展代替多個請求。
• 利用多查詢進行批量操作。

常見查詢問題

• 無結果：檢查拼寫，嘗試更寬泛的搜索詞。
• 缺少字段：某些字段可能為空，請妥善處理。
• 查詢語法錯誤：驗證 Apicalypse 語法，檢查分號。

環境變量

確保你的 MCP 客戶端配置包含以下內容：

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

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

鳴謝：

• IGDB API 由 IGDB.com 提供。
• MCP 協議由 Anthropic 開發。
• 基於 FastMCP 構建。
• 發佈於 Smithery。

如需瞭解更多關於 IGDB API 功能的信息，請訪問 IGDB API 官方文檔。