MCP LaunchBox

AIアシスタントがLaunchBoxのゲームライブラリを照会できるようにするMCPサーバーです。Steam、GOG、Epic、エミュレーターなど、すべてのプラットフォームにわたるゲームコレクション全体を、AIアシスタントから直接検索できます。

Claude Desktop、Claude Code、またはMCP互換クライアントで動作します。

ユースケース

• ゲームバンドルのスクリーンショットを送信して、すでに所有しているゲームを確認する（あいまい一致によりOCRエラーやタイプミスにも対応）

• セール中のゲームを購入する前のクイック検索

• プラットフォームや名前でライブラリを閲覧

• ゲームのプレイ時間を確認

• インストール済みでまだプレイしていないゲームを探す

• プラットフォームを横断して現在プレイ中のゲームを確認する

Related MCP server: gamelibs-mcp

セットアップ

Node.js 20以上が必要です。

1. LaunchBoxのインストール

ゲームデータを含むLaunchBoxがインストールされている必要があります。

2. MCPクライアントの設定

MCPクライアントの設定にサーバーを追加します。方法は2通りあります：

オプション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の一致のみが含まれます。一致が見つからない場合、診断用に最大5つの近い候補が nearMisses に表示されます。句読点は、デフォルトで照合前に正規化されます。

バンドルの重複チェック用に設計されています。1つずつ検索するのではなく、すべてのタイトルを1回の呼び出しで渡してください。すべてのプラットフォームを横断して確認するには platform を省略してください（バンドルにはこちらを推奨）。

ツール：check_library

ゲーム詳細の取得

IDを指定して特定のゲームの詳細を取得します。タイトル、プラットフォーム、開発者、ジャンル（配列）、シリーズ、評価（communityStarRatingとstarRating、両方とも0～5）、プレイ時間（{seconds, hours}）、インストール状況など、すべてのメタデータをcamelCaseで返します。空または欠落している文字列フィールドは null になります。

ツール：get_game_details

プラットフォーム一覧の表示

ライブラリ内のすべてのプラットフォームと、それぞれのゲーム数を一覧表示します。パラメータは不要です。

ツール：list_platforms

重複の検索

タイトルごとにグループ化された重複ゲームエントリを検索します。プラットフォーム間および同一プラットフォーム内の重複が含まれます。

ツール：find_duplicates

統計の取得

ライブラリの概要統計（合計ゲーム数、合計プラットフォーム数、ゲーム数上位10プラットフォーム）を取得します。パラメータは不要です。

ツール：get_stats

ライブラリの再読み込み

ディスクからすべてのゲームデータを再読み込みします。LaunchBoxでゲームを追加または削除した後に使用してください。パラメータは不要です。

ツール：reload_library

ライセンス

MIT