MCP发射箱
一 主控程序 服务器,让AI助手查询您的 LaunchBox 游戏库。直接从您的AI助手在所有平台(Steam、GOG、Epic、模拟器等)上搜索您的整个游戏收藏。
适用于Claude Desktop、Claude Code或任何兼容MCP的客户端。
______________________________________________________________________
用例
- 发送游戏捆绑包的屏幕截图,并检查您已经拥有哪些捆绑包——模糊匹配可以处理OCR错误和拼写错误
- 在购买打折游戏之前快速查找
- 按平台或名称浏览您的库
- 检查你在游戏上花了多少时间
- 查找您尚未玩过的已安装游戏
- 查看您当前在跨平台上玩的游戏
______________________________________________________________________
设置
需要 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
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | string | 是 | 搜索文本以匹配标题和系列 |
platform | string | 否 | 按平台名称筛选 |
limit | number | 否 | 返回的最大结果数(默认值25) |
exact | boolean | 否 | 禁用标点符号规范化(默认为false) |
检查库
检查列表中的哪些游戏已在库中。首先使用精确的标题匹配,然后使用模糊匹配——只包括置信度≥0.85的匹配,以避免误报。当没有找到匹配时, nearMisses 最多显示5个接近的诊断候选者。默认情况下,匹配前会对标点符号进行标准化处理。
专为捆绑包重复检查而设计——在一次调用中传递所有标题,而不是一次搜索一个。省略 platform 检查所有平台(建议捆绑使用)。
工具: check_library
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
games | string\[\] | Yes | 要查找的游戏标题字符串数组 |
platform | string | 否 | 筛选器与特定平台匹配 |
limit | number | No | 要处理的最大标题数(默认值100) |
exact | boolean | 否 | 禁用标点符号规范化(默认为false) |
获取游戏详细信息
按ID获取特定游戏的完整详细信息。返回camelCase中的所有元数据:标题、平台、开发者、流派(数组)、系列、评级(communityStarRating和starRating,均为0-5)、播放时间({秒,小时})、安装状态等。字符串字段为 null 当空/丢失时。
工具: get_game_details
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | 游戏ID(来自搜索结果的UUID) |
include_notes | boolean | 否 | 包含Notes字段(默认为false) |
列出平台
列出库中的所有平台及其游戏计数。不需要参数。
工具: list_platforms
参考文献查重
查找按标题分组的重复游戏条目——包括跨平台和同一平台的重复项。
工具: find_duplicates
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | string | 否 | 可选标题过滤器(模糊匹配) |
limit | number | 否 | 要返回的最大重复组数(默认值25) |
获取统计信息
获取库摘要统计数据(游戏总数、平台总数、游戏计数前10名平台)。不需要参数。
工具: get_stats
重新加载库
从磁盘重新加载所有游戏数据。在LaunchBox中添加或删除游戏后使用。不需要参数。
工具: reload_library
______________________________________________________________________
