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》的详细信息”
• “告诉我关于《Cyberpunk 2077》的一切，包括 DLC”
• “《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”：检查 MCP 客户端配置中是否包含环境变量
• “凭据无效”：确认 Client ID 和 Secret 是否正确
• “令牌已过期”：服务会自动处理令牌刷新

速率限制

IGDB 允许每秒发送 4 个请求。服务未实现速率限制，因此：

• 避免快速重复查询
• 使用字段扩展，而非发送多个请求
• 使用多查询进行批量操作

常见查询问题

• 没有结果：检查拼写，并尝试更宽泛的搜索词
• 缺少字段：某些字段可能为 null；请妥善处理
• 查询语法错误：确认 Apicalypse 语法正确，并检查分号

环境变量

确保 MCP 客户端配置包含：

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

许可证与鸣谢

MIT 许可证 - 详情请参阅 LICENSE 文件

鸣谢：

• IGDB API 由 IGDB.com 提供
• MCP 协议由 Anthropic 提供
• 使用 FastMCP 构建

---

如需了解有关 IGDB API 功能的更多信息，请访问 IGDB API 官方文档。