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