Game MCP

🚀 遊戲發現MCP服務器

這是一個模型上下文協議（MCP）服務器，可在Windows PC上發現並管理來自多個平臺的已安裝遊戲，這些平臺包括Steam、Epic Games、GOG、Windows應用商店/Xbox，以及其他已安裝的程序。

🚀 快速開始

本項目依賴於.NET 10.0或更高版本，且僅支持Windows操作系統。

✨ 主要特性

• 多平臺遊戲發現：自動掃描以下平臺的遊戲：
  • Steam（包括自定義庫位置）
  • Epic Games Store
  • GOG（Good Old Games）
  • Xbox/Windows應用商店遊戲
  • EA遊戲
  • Ubisoft Connect遊戲
  • Rockstar遊戲
  • Battle.Net遊戲
  • 其他已安裝程序（通過Windows註冊表）
• 全面的遊戲信息：提供詳細信息，包括：
  • 遊戲名稱和平臺
  • 安裝路徑和可執行文件位置
  • 安裝日期和大小
  • 特定平臺的元數據
• 可用的MCP工具：
  • discover_games：查找所有平臺上安裝的所有遊戲
  • get_game_info：獲取特定遊戲的詳細信息
  • launch_game：按名稱啟動遊戲（如果找到可執行文件）

📦 安裝指南

本項目依賴於.NET 10.0或更高版本，且僅支持Windows操作系統。

💻 使用示例

基礎用法

在VS Code中使用的配置示例：

{
  "servers": {
    "McpServer1": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "GameMcpServer@1.0.4",
        "--yes"
      ]
    }
  }
}

高級用法

以下是各個工具的使用說明：

discover_games

發現所有受支持平臺上安裝的所有遊戲。

在Claude中的示例用法： "Can you discover all the games I have installed on my PC?"

返回：包含以下內容的JSON對象：

• 遊戲總數
• 按平臺分組的遊戲
• 包含元數據的所有遊戲的詳細列表

get_game_info

按名稱獲取特定遊戲的詳細信息。

參數：

• gameName：要搜索的遊戲名稱

示例用法： "Get information about Cyberpunk 2077"

launch_game

如果遊戲有有效的可執行路徑，則按名稱啟動遊戲。

參數：

• gameName：要啟動的遊戲的確切名稱

示例用法： "Launch Steam's Half-Life 2"

🔧 技術細節

工作原理

服務器使用多種發現方法：

1. Steam遊戲：
   • 從註冊表中讀取Steam安裝路徑
   • 解析libraryfolders.vdf以獲取自定義庫位置
   • 掃描steamapps/common目錄以查找遊戲文件夾
2. Epic Games：
   • 從%ProgramData%/Epic/EpicGamesLauncher/Data/Manifests讀取遊戲清單
   • 解析JSON清單文件以獲取遊戲信息
3. GOG遊戲：
   • 在SOFTWARE\GOG.com\Games下查詢Windows註冊表
   • 提取遊戲路徑和可執行文件信息
4. Xbox/Windows應用商店：
   • 掃描%ProgramFiles%/WindowsApps目錄
   • 解析AppxManifest.xml文件以獲取應用程序信息
   • 過濾遊戲應用程序
5. 註冊表程序：
   • 掃描Windows卸載註冊表項
   • 使用啟發式方法識別類似遊戲的應用程序
   • 過濾掉系統實用程序和非遊戲軟件

錯誤處理

服務器設計為即使在以下情況下也能保持健壯並繼續運行：

• 某些平臺未安裝
• 註冊表項無法訪問
• 目錄有權限限制
• 個別遊戲的元數據損壞 錯誤會記錄到標準錯誤輸出，並且不會中斷其他平臺的發現過程。

安全考慮

• 服務器僅讀取系統信息，不進行任何修改
• 遊戲啟動需要通過MCP客戶端獲得用戶的明確確認
• 除了啟動可執行文件外，所有文件系統訪問都是隻讀的
• 註冊表訪問是隻讀的

📚 詳細文檔

開發依賴

本項目使用以下技術：

• .NET 10.0
• .NET的模型上下文協議SDK
• Microsoft.Extensions.Hosting用於應用程序生命週期管理