game-mcp

Game Discovery MCP Server

一个 Model Context Protocol (MCP) 服务，可发现和管理 Windows PC 上从 Steam、Epic Games、GOG、Windows Store/Xbox 及其他平台安装的游戏。

功能

• 多平台游戏发现：自动扫描以下平台中的游戏：

  • Steam（包括自定义库位置）
  • Epic Games Store
  • GOG（Good Old Games）
  • Xbox/Windows Store 游戏
  • EA 游戏
  • Ubisoft Connect 游戏
  • Rockstar 游戏
  • Battle.Net 游戏
  • 其他已安装程序（通过 Windows 注册表）

• 全面的游戏信息：提供以下详细信息：

  • 游戏名称和平台
  • 安装路径和可执行文件位置
  • 安装日期和大小
  • 平台专属元数据

• 可用的 MCP 工具：

  • discover_games：查找所有平台上已安装的游戏
  • get_game_info：获取特定游戏的详细信息
  • launch_game：按名称启动游戏（如果找到可执行文件）

先决条件

• .NET 10.0 或更高版本
• Windows 操作系统

与 VS Code 配合使用

{
  "servers": {
    "GameMcpServer": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "[email protected]",
        "--yes"
      ]
    }
  }
}

可用工具

discover_games

发现所有受支持平台上已安装的游戏。

在 Claude 中的用法示例： “可以查找我在 PC 上安装的所有游戏吗？”

**返回：**包含以下内容的 JSON 对象：

• 游戏总数
• 按平台分组的游戏
• 包含元数据的完整游戏列表

get_game_info

按名称获取特定游戏的详细信息。

参数：

• gameName：要搜索的游戏名称

用法示例： “获取 Cyberpunk 2077 的信息”

launch_game

如果游戏具有有效的可执行文件路径，则按名称启动游戏。

参数：

• gameName：要启动的游戏的准确名称

用法示例： “启动 Steam 上的 Half-Life 2”

工作原理

该服务使用多种发现方法：

1. Steam 游戏：

   • 从注册表读取 Steam 安装路径
   • 解析 libraryfolders.vdf 以获取自定义库位置
   • 扫描 steamapps/common 目录中的游戏文件夹

2. Epic Games：

   • 从 %ProgramData%/Epic/EpicGamesLauncher/Data/Manifests 读取游戏清单
   • 解析 JSON 清单文件以获取游戏信息

3. GOG 游戏：

   • 查询 Windows 注册表中的 SOFTWARE\GOG.com\Games
   • 提取游戏路径和可执行文件信息

4. Xbox/Windows Store：

   • 扫描 %ProgramFiles%/WindowsApps 目录
   • 解析 AppxManifest.xml 文件以获取应用程序信息
   • 筛选游戏应用程序

5. 注册表程序：

   • 扫描 Windows 卸载注册表项
   • 使用启发式方法识别类似游戏的应用程序
   • 筛除系统实用工具和非游戏软件

错误处理

该服务经过稳健性设计，即使遇到以下情况也能继续运行：

• 未安装某些平台
• 无法访问注册表项
• 目录存在权限限制
• 个别游戏的元数据已损坏

错误会记录到 stderr，不会中断其他平台的发现过程。

安全注意事项

• 该服务只读取系统信息，不会修改任何内容
• 启动游戏需要通过 MCP 客户端获得用户明确确认
• 所有文件系统访问均为只读，启动可执行文件除外
• 注册表访问为只读

开发

本项目使用：

• .NET 10.0
• 适用于 .NET 的 Model Context Protocol SDK
• Microsoft.Extensions.Hosting 管理应用程序生命周期