Igdb

@pipeworx/igdb

IGDB（Internet Game Database，Twitch/Amazon）——约 300,000 款电子游戏的权威目录：按平台划分的发行日期、类型、评分、开发商、发行商、系列和封面图。

属于 Pipeworx——一个将 AI Agent 连接到 1881+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联，未经其认可，也并非由其发布。

工具

• igdb_search_games(query) — 按游戏名称搜索，可选按平台或发行时间范围筛选。
• igdb_game(id | slug) — 查看单款游戏的完整信息，包括按平台划分的发行日期、DLC、扩展内容和相似游戏。
• igdb_companies(query) — 搜索开发商和发行商，以及他们发行过的作品。
• igdb_platforms(query) — 搜索约 200 个平台；其 ID 可用于限定游戏搜索范围。

身份验证

使用平台密钥（PLATFORM_TWITCH_KEY），并支持通过 _apiKey 使用自带密钥。

凭据与 twitch 包使用的 Twitch 应用相同——IGDB 通过 Twitch OAuth 进行访问控制，因此 _apiKey 的格式为 "CLIENT_ID:CLIENT_SECRET"，此包会在每次调用时用它换取应用访问令牌。此包没有添加新的网关绑定，而是声明使用现有的 PLATFORM_TWITCH_KEY。

希望使用独立速率配额的调用方，可在 https://dev.twitch.tv/console 免费获取凭据。

数据源

• https://id.twitch.tv/oauth2/token — 客户端凭据授权。
• https://api.igdb.com/v4/games、/companies、/platforms — POST 请求，使用 Apicalypse 请求体。

以下要点可以避免后来者重复摸索：

• API 仅支持 POST，请求体使用 DSL，而非 JSON。 fields name,summary; search "zelda"; limit 10;——每个子句都必须以分号结尾。
• fields 为必填项，省略后会返回空对象，而不是报错。 这是这里容易导致结果静默为空的陷阱；此包始终会发送明确的字段列表。
• search 和 sort 不能出现在同一条查询中。 search "x" 会按相关性排序；where name ~ *"x"* 是可排序的子串筛选条件。游戏和公司工具使用前者，igdb_platforms 使用后者。
• first_release_date 和 start_date 使用 Unix 秒数，而非字符串。每个日期也会以 ISO 日期格式返回。
• 封面图和徽标的 image_id 值会转换为如下 URL：https://images.igdb.com/igdb/image/upload/<size>/<image_id>.jpg。
• IGDB 游戏 ID 与 Twitch 游戏 ID 属于同一个 ID 空间，因此此包可以与 twitch 配合使用。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "igdb": {
      "url": "https://gateway.pipeworx.io/igdb/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/igdb/mcp 上的 tools/list 除了返回上表中的工具，还会返回 Pipeworx 通用元工具——ask_pipeworx、discover_tools、search_within、remember/recall 以及整个网关共用的其他工具。因此，你看到的工具数量会多于上表所列：目前，单包端点除了该包自身的工具外，还会列出约 30 个通用工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威说明。

这是有意为之，并非意外进行了多路复用。元工具让受限连接也能回答此包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——无需再添加第二个 MCP 服务。目前无法挂载不包含这些工具的包端点；如果额外的 schema 占用的上下文超过了路由功能带来的价值，建议连接完整网关一次，而不是连接多个包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有包的工具，而不只是此包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和同一组 1881+ 个数据源。唯一的区别是哪些包的工具会被直接列出；无论使用哪个 URL，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/igdb_search_games \
  -H 'Content-Type: application/json' \
  -d '{"query":"Breath of the Wild","limit":5}'

首次调用无需账号。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/igdb_search_games。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账号）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账号，也无需经过网关：

{
  "mcpServers": {
    "igdb": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-igdb"]
    }
  }
}

或者直接运行，确认它可以启动：

npx -y @pipeworx/mcp-igdb

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此软件包的工具——不包含上述网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无需通过 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不必直接调用工具——此功能既适用于上述软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Igdb data" })

网关会选择合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT