Game MCP

🚀 ゲームディスカバリMCPサーバー

このサーバーは、Model Context Protocol (MCP) を用いて、Windows PC上にインストールされたSteam、Epic Games、GOG、Windows Store/Xboxなど様々なプラットフォームのゲームを発見し、管理することができます。

🚀 クイックスタート

このサーバーを使用するには、.NET 10.0以上とWindowsオペレーティングシステムが必要です。

✨ 主な機能

• 多プラットフォーム対応のゲーム発見: 以下のプラットフォームから自動的にゲームをスキャンします。
  • 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: 有効な実行ファイルパスがある場合、ゲームを名前で起動します。

📦 インストール

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 Store:
   • %ProgramFiles%/WindowsApps ディレクトリをスキャンします。
   • AppxManifest.xmlファイルを解析してアプリケーション情報を取得します。
   • ゲームアプリケーションをフィルタリングします。
5. レジストリプログラム:
   • Windowsのアンインストールレジストリエントリをスキャンします。
   • ヒューリスティックを使用してゲームのようなアプリケーションを識別します。
   • システムユーティリティや非ゲームソフトウェアをフィルタリングします。

📚 ドキュメント

エラーハンドリング

このサーバーは、いくつかのプラットフォームがインストールされていない場合、レジストリキーにアクセスできない場合、ディレクトリにアクセス許可の制限がある場合、個々のゲームのメタデータが破損している場合でも、堅牢に動作し続けるように設計されています。エラーはstderrにログが記録され、他のプラットフォームの発見プロセスを中断することはありません。

セキュリティに関する考慮事項

• サーバーはシステム情報の読み取りのみを行い、何も変更しません。
• ゲームの起動には、MCPクライアントを通じた明示的なユーザーの確認が必要です。
• ファイルシステムへのアクセスは、実行ファイルの起動を除いて読み取り専用です。
• レジストリへのアクセスは読み取り専用です。

開発について

このプロジェクトでは、以下のものを使用しています。

• .NET 10.0
• Model Context Protocol SDK for .NET
• Microsoft.Extensions.Hosting for application lifecycle