MCP LaunchBox

一个 MCP 服务器，允许 AI 助手查询您的 LaunchBox 游戏库。直接从您的 AI 助手搜索您在所有平台（Steam、GOG、Epic、模拟器等）上的整个游戏收藏。

适用于 Claude Desktop、Claude Code 或任何兼容 MCP 的客户端。

使用场景

• 发送游戏捆绑包的截图并检查您已经拥有哪些游戏 —— 模糊匹配可处理 OCR 错误和拼写错误

• 在购买打折游戏前进行快速查询

• 按平台或名称浏览您的游戏库

• 查看您在某款游戏上花费了多少时间

• 查找您尚未玩过的已安装游戏

• 查看您目前在各平台上的游玩情况

Related MCP server: gamelibs-mcp

设置

需要 Node.js 20+。

1. 拥有 LaunchBox 安装

您需要安装 LaunchBox 并拥有您的游戏数据。

2. 配置您的 MCP 客户端

将服务器添加到您的 MCP 客户端配置中。有两种方法可以做到这一点：

选项 A：直接从 GitHub 运行（无需安装）

{
  "mcpServers": {
    "launchbox": {
      "command": "npx",
      "args": ["-y", "github:danjam/mcp-launchbox"],
      "env": {
        "LAUNCHBOX_PLATFORMS_PATH": "C:/LaunchBox/Data/Platforms"
      }
    }
  }
}

选项 B：克隆并在本地运行

git clone https://github.com/danjam/mcp-launchbox.git
cd mcp-launchbox
npm install

然后将您的 MCP 客户端指向本地构建：

{
  "mcpServers": {
    "launchbox": {
      "command": "node",
      "args": ["/path/to/mcp-launchbox/dist/index.js"],
      "env": {
        "LAUNCHBOX_PLATFORMS_PATH": "C:/LaunchBox/Data/Platforms"
      }
    }
  }
}

将 /path/to/mcp-launchbox 替换为您克隆项目的实际路径。

您可以做什么

搜索游戏

按标题搜索游戏库。在标题和系列字段中使用模糊匹配。默认情况下，标点符号（破折号、冒号、&/and）在匹配前会被标准化。

置信度量表：1.0 = 完美匹配，≥0.85 = 极有可能，≥0.65 = 可能，<0.65 = 推测。使用 get_game_details 获取完整元数据。

工具：search_games

检查游戏库

检查列表中的哪些游戏已在游戏库中。首先使用精确标题匹配，然后使用模糊匹配 —— 仅包含置信度 ≥0.85 的匹配项，以避免误报。当未找到匹配项时，nearMisses 会显示最多 5 个相近的候选者以供诊断。默认情况下，标点符号在匹配前会被标准化。

专为捆绑包重复检查而设计 —— 在一次调用中传递所有标题，而不是逐个搜索。省略 platform 以跨所有平台进行检查（推荐用于捆绑包）。

工具：check_library

获取游戏详情

通过 ID 获取特定游戏的完整详情。以 camelCase 返回所有元数据：标题、平台、开发者、类型（数组）、系列、评分（communityStarRating 和 starRating，均为 0–5）、游玩时间（{seconds, hours}）、安装状态等。当字符串字段为空/缺失时为 null。

工具：get_game_details

列出平台

列出游戏库中的所有平台及其游戏数量。无需参数。

工具：list_platforms

查找重复项

查找按标题分组的重复游戏条目 —— 包括跨平台和同平台重复项。

工具：find_duplicates

获取统计信息

获取游戏库摘要统计信息（总游戏数、总平台数、按游戏数量排名前 10 的平台）。无需参数。

工具：get_stats

重新加载游戏库

从磁盘重新加载所有游戏数据。在 LaunchBox 中添加或删除游戏后使用。无需参数。

工具：reload_library

许可证

MIT