JinDaGe - igdb-mcp-server MCP Details

article

README

🚀 IGDB MCP Server

IGDB MCP Server 允许你通过模型上下文协议（MCP）访问互联网游戏数据库（IGDB）API，为你提供丰富的游戏信息查询服务。

🚀 快速开始

获取 IGDB 凭证

如果你还没有 Twitch 账户，请创建一个 Twitch 账户。
访问 Twitch 开发者控制台，注册你的应用程序。
获取你的 客户端 ID 并生成一个 客户端密钥。

📖 完整的 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"
      }
    }
  }
}

开始探索

使用以下示例提示开始探索： 🔍 搜索与发现

"搜索《艾尔登法环》及其扩展内容"
"查找过去 5 年发布的所有《女神异闻录》系列游戏"
"展示与《哈迪斯》类似的游戏"

📊 游戏信息

"获取《博德之门 3》的详细信息"
"告诉我关于《赛博朋克 2077》的所有信息，包括 DLC"
"《霍格沃茨之遗》在哪些平台上可用？"

🔥 热门与流行

"哪些是最受期待的即将推出的游戏？"
"展示 2024 年评分最高的独立游戏"
"查找当前最受关注的游戏"

🎯 高级查询

"查找与《上古卷轴 5：天际》类似且评分在 85 分以上的游戏"
"列出拉瑞安工作室开发的所有游戏"
"展示即将推出的《寂静岭》和《生化危机》系列游戏"

✨ 主要特性

全面的 IGDB API 访问：可搜索游戏、获取详细信息、查找热门游戏。
智能缓存：对 OAuth 令牌进行缓存，以减少身份验证开销。
灵活查询：支持简单搜索或使用高级 Apicalypse 查询语言。
预构建提示：提供常用查询，随时可用。
类型安全：使用 Pydantic 构建，确保数据验证的健壮性。

🔧 技术细节

核心组件

工具

| 工具 | 描述 | 参数 | 示例用法 | |------|-------------|------------|---------------| | search_games | 按名称搜索游戏 | • query（必需）：搜索词
• fields：返回的字段（默认：基本信息）
• limit：结果数量（1 - 500，默认：10） | "搜索《艾尔登法环》相关游戏" | | 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 的角色扮演游戏" |

资源

| 资源 | 描述 | 返回内容 | |----------|-------------|---------| | igdb://endpoints | 所有 IGDB API 端点列表 | 可用端点及其描述 | | igdb://query-syntax | Apicalypse 查询语言指南 | 语法参考和示例 |

预构建提示

| 提示 | 描述 | 使用场景 | |--------|-------------|----------| | search_game | 格式化的游戏搜索结果 | 快速发现游戏，输出简洁 | | game_details | 全面的游戏信息 | 获取包括评分、平台、开发者在内的详细信息 | | most_anticipated | 热门即将推出的游戏 | 发现备受关注的未发布游戏及相关统计信息 |

📚 详细文档

故障排除

身份验证错误

“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 官方文档。

igdb-mcp-server