steam-local-mcp

Steam Local MCP

現在の Windows ユーザー向けにインストールされた Steam クライアントを、MCP 対応エージェントから操作できる、無料のオープンソース Windows 用 Model Context Protocol サーバーです。

エージェントに、インストール済みゲームの検索、起動、Steam ページの表示、ローカルのダウンロード／更新状況の確認、ストアの検索、Steam ライブラリのストレージ概要の表示を依頼できます。リクエストされたクライアント操作に必要な場合、Steam はバックグラウンドで静かに起動します。

これは標準的な stdio MCP サーバーです。特定のエージェントに依存しないため、ローカルコマンドを実行できる Codex、Claude、またはその他の MCP クライアントで使用できます。

使用例

User: "Pick a strategy game for me to play."

Agent: 🛠️ Calling steam_list_games()

Agent: "How about Balatro? Should I launch it?"

User: "Yes."

Agent: 🛠️ Calling steam_launch_game(app_id: 2861700)

Agent: "Launched Balatro."

できること

ローカル Steam ツール — API キー不要

• steam_list_games と steam_find_game — 設定済みのすべての Steam ライブラリから、ローカルにインストールされたゲームを確認します。
• steam_launch_game — 名前または app ID を指定して、インストール済みのゲームを起動します。
• steam_get_game_install_status と steam_get_download_status — マニフェストに記録されたインストール、更新、ダウンロード、一時停止中のダウンロードの状態を確認します。
• steam_get_library_storage — ローカルの各 Steam ライブラリについて、インストール済みサイズと空きディスク容量を表示します。
• steam_open_library_page、steam_open_store_page、steam_open_client_page — Steam クライアント内のページに移動します。
• steam_install_game — Steam に app ID のインストールを依頼します。所有権の確認とインストールの進行管理は Steam が行います。
• steam_client_status — 検出された Steam のインストール情報、検出元、Steam が実行中かどうかを報告します。

公開ストアツール — API キー不要

• steam_search_store — ゲーム名からストアの app ID を検索します。
• steam_get_game_details — 公開メタデータ、価格、ジャンル、発売日、Metacritic スコアを取得します。

オプションのアカウントツール — Steam Web API キーが必要

STEAM_API_KEY と STEAM_ID を設定すると、以下が有効になります。

• steam_api_status — API 認証情報が設定済みで有効か、Steam の Web API に接続されているかを確認します。
• steam_get_library — 所有ゲーム、プレイ時間、最終プレイ日時、フィルタリング、ページネーション。
• steam_get_recently_played — 直近 2 週間のプレイ時間順に並べた、最近プレイしたゲーム。

必要要件

• Windows 10 以降
• 現在の Windows ユーザー向けに Steam がインストールされていること
• Node.js 20 以降

npm からインストール

公開パッケージを npm からインストールするには、以下と同等の設定を MCP クライアントに追加します。

{
  "mcpServers": {
    "steam": {
      "command": "npx",
      "args": ["-y", "steam-local-mcp"]
    }
  }
}

設定ファイルの場所はエージェントによって異なりますが、上記のコマンドと引数は同じです。設定を保存した後、MCP クライアントを再起動するか、再接続してください。

インストールを手動で確認するには、以下を実行します。

npx -y steam-local-mcp print-config

ソースからインストール

開発時、ソースの監査時、または npm リリースがまだ利用できない場合に使用します。

git clone https://github.com/Jackson-Brooks/steam-local-mcp.git
cd steam-local-mcp
npm install
npm run build

次に、クローンしたディレクトリ内のコンパイル済みエントリーポイントを実行するよう、MCP クライアントを設定します。

{
  "mcpServers": {
    "steam": {
      "command": "node",
      "args": ["C:\\path\\to\\steam-local-mcp\\dist\\src\\index.js"]
    }
  }
}

C:\path\to\steam-local-mcp を、クローンした場所に置き換えてください。他のユーザーのパスは使用しないでください。

オプションの Steam Web API 設定

MCP クライアントの環境設定またはオペレーティングシステムの環境変数を通じて、認証情報を渡します。

{
  "mcpServers": {
    "steam": {
      "command": "npx",
      "args": ["-y", "steam-local-mcp"],
      "env": {
        "STEAM_API_KEY": "your_key",
        "STEAM_ID": "your_64_bit_steam_id"
      }
    }
  }
}

サーバーが .env ファイルを自動的に読み込むことはありません。認証情報をコミットしないでください。Steam プロフィールやゲーム詳細のプライバシー設定によって、アカウントツールからデータを取得できない場合があります。非公開プロフィールでも、ローカルクライアントの操作は引き続き利用できます。

Steam API 認証情報の取得

1. ブラウザーで Steam にサインインし、Steam Web API キーページを開きます。
2. キーを作成またはコピーし、MCP クライアントの環境設定で STEAM_API_KEY として設定します。キーは非公開にしてください。
3. STEAM_ID には、アカウント名ではなく数値の 64 ビット Steam ID を設定します。これは通常、https://steamcommunity.com/profiles/7656119... のようなプロフィール URL で確認できます。
4. MCP クライアントを再起動または再接続し、steam_api_status を呼び出して認証情報が設定されていることを確認します。

キーを設定すると、エージェントは「未プレイの Steam ゲームを表示して」や「最近プレイしたゲームは？」といったリクエストに回答できます。キーは任意です。ゲームの起動、ローカルのインストール状態、ストレージ、ストア検索、ストアのメタデータは、キーがなくても利用できます。

Steam の検出とローカルの状態

Steam Local MCP は、次の順序で確認します。

1. STEAM_PATH — Steam ディレクトリ、またはその steam.exe
2. 現在のユーザーおよびマシンの Valve レジストリキー
3. 一般的なユーザー別の場所、Program Files、C:\Steam
4. PATH 上の steam.exe

選択されたパスと検出元を確認するには、steam_client_status を使用します。ポータブル版や通常とは異なるカスタムドライブへのインストールでは、STEAM_PATH に steam.exe を含むディレクトリを設定してください。

インストール／ダウンロードツールは、Steam のローカルアプリマニフェストを読み取ります。needs_update: true は、Steam が更新を保留中としてすでに記録していることを意味します。false は、保留中の更新が現在ローカルに記録されていないことを意味します。ネットワーク経由で更新を確認することはありません。

プライバシーと安全性

• ローカルツールはローカルの Steam ファイルを読み取り、Steam URI を開きます。Steam Web API キーは必要ありません。
• steam_launch_game は、ローカルのインストール済みゲームマニフェストで見つかったゲームのみを起動します。
• 操作に必要な場合、Steam はまず表示されるランチャーウィンドウを開くのではなく、非表示で起動します。
• 購入やアンインストールを行うツールはありません。
• 公開ストアの説明文はデフォルトで省略されます。明示的に要求された場合、説明文の長さは制限され、プレーンテキストに変換されたうえで、信頼できない外部コンテンツとしてマークされます。
• Web API とストアの応答は、デフォルトで %LOCALAPPDATA%\steam-local-mcp\cache にローカルキャッシュされます。保存先を変更するには STEAM_MCP_CACHE_DIR を設定し、キャッシュを消去するには steam_refresh_cache を呼び出します。

開発

npm install
npm test
npm pack --dry-run

テストスイートには、ローカルの解析／キャッシュのテスト、モックを使ったストアと API のテスト、すべてのツールを対象とした MCP プロトコルのテスト、パッケージ化されたエントリーポイントを使った実際の stdio ハンドシェイクが含まれています。

コントリビューション

Issue とプルリクエストを歓迎します。動作を変更する場合は回帰テストを追加し、明示的に設計・文書化されていない限り、破壊的な Steam 操作は対象外としてください。

ライセンス

MIT