Windowssandboxmcp

🚀 Windows Sandbox MCP

Model-View-Controller (MCP)プロトコルを通じてWindowsサンドボックスインスタンスを管理する.NETツールです。

⚠️ 重要提示

このプロジェクトは現在実験段階です。バグや制限事項が含まれる可能性があります。フィードバックとテストを歓迎しますが、現時点では本番環境での使用は推奨されません。

問題を報告し、フィードバックを提供して、プロジェクトの改善にご協力ください！

🚀 クイックスタート

必要条件

⚠️ 重要: このツールはWindows 11 24H2以降が必要です。Windows 10またはそれ以前のWindows 11バージョンでは動作しません。

このMCPサーバーは、新しいWindowsサンドボックスアーキテクチャと wsb.exe CLIツールに依存しており、これらはWindows 11 24H2以降のバージョンでのみ利用可能です。

• Windows 11 24H2以降 (必須)
• .NET 10.0 SDK
• Windows Sandbox

ビルド

dotnet build

使用方法

このMCPサーバーは、Claude DesktopやVS Codeなど、MCP互換のクライアントと共に使用できます。

Claude Desktopでの使用

1. プロジェクトのビルド

dotnet build -c Release

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

2.1. Claude Desktop

以下の場所にある claude_desktop_config.json ファイルを開きます。

%AppData%\Claude\claude_desktop_config.json

日常使用の場合は、以下のように設定します。

{
  "mcpServers": {
    "windows-sandbox": {
      "command": "dnx",
      "args": [
        "WindowsSandboxMcp",
        "--yes"
      ]
    }
  }
}

開発用の場合は、以下のように設定します。

{
  "mcpServers": {
    "windows-sandbox": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "D:\\projects\\WindowsSandboxMcp\\src\\WindowsSandboxMcp\\WindowsSandboxMcp.csproj"
      ]
    }
  }
}

2.2. Visual Studio Code

VS Codeの設定 (Ctrl + ,) を開き、「MCP」を検索するか、直接 settings.json を編集します。

日常使用の場合は、以下のように設定します。

{
  "servers": {
    "windows-sandbox": {
      "type": "stdio",
      "command": "dnx",
      "args": ["WindowsSandboxMcp", "--yes"]
    }
  }
}

開発用の場合は、以下のように設定します。

{
  "servers": {
    "windows-sandbox": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "D:\\projects\\WindowsSandboxMcp\\src\\WindowsSandboxMcp\\WindowsSandboxMcp.csproj"]
    }
  }
}

絶対パスを使用する必要があります。PowerShellで pwd コマンドを使用して、プロジェクトの絶対パスを確認できます。

3. Claude Desktopの再起動

設定ファイルを保存した後、Claude Desktopを完全に閉じて再起動します。 システムトレイのClaudeアイコンを右クリックし、「終了」を選択します。

✨ 主な機能

このMCPサーバーは、以下の機能を通じてWindowsサンドボックスをプログラムで制御できます。

• サンドボックスのライフサイクル管理 - カスタム設定でWindowsサンドボックスインスタンスを開始および停止します。
• コマンド実行 - サンドボックス環境内でコマンドやスクリプトを実行します。
• 共有フォルダ - ファイル共有のためにホストディレクトリをサンドボックスにマップします。
• ネットワーク情報 - ネットワーク設定とIPアドレスを取得します。
• セッション管理 - サンドボックスセッションに接続し、監視します。
• ステータス監視 - サンドボックスが現在実行中かどうかを確認します。

注意: 利用可能なツールとそのパラメータは、プロジェクトの進展に伴って変更される可能性があります。MCPクライアントのツール探索機能を使用して、現在利用可能なツールのリストとその仕様を確認してください。

使用例

Claude Desktopに以下のような質問をすることができます。

• "新しいWindowsサンドボックスを起動する"
• "サンドボックス内でメモ帳を実行する"
• "サンドボックスのネットワーク情報を取得する"
• "サンドボックスを停止する"
• "サンドボックスに共有フォルダを追加する"
• "サンドボックスが現在実行中か？"

🔧 技術詳細

アーキテクチャ

このMCPサーバーは、Windows 11 24H2で導入された新しいWindowsサンドボックスアーキテクチャを使用しており、wsb.exe CLIツールを通じてプログラムで制御できます。

依存関係:

• ModelContextProtocol (v0.4.0-preview.3) - コアMCP実装
• Microsoft.Extensions.Hosting (v10.0.0) - アプリケーションホスティングインフラストラクチャ
• System.Management (v10.0.0) - プロセス管理のためのWMI統合
• wsb.exe - WindowsサンドボックスCLIツール (Windows 11 24H2以降に組み込まれています)

プロジェクト構造

• Program.cs - エントリポイントとMCPサーバーの初期化
• WindowsSandbox.cs - 高レベルのWindowsサンドボックスAPI
• WindowsSandboxCliRaw.cs - 低レベルのCLIラッパー
• Tools/WindowsSandboxTools.cs - MCPツールの定義
• Models/ - 設定とデータモデル

主要機能

• 単一のサンドボックスインスタンス管理 (複数のサンドボックスが同時に実行されるのを防止)
• 自動接続と準備完了検出
• リモートセッションウィンドウ管理
• アクティブなセッションのWMIベースのプロセス検出

🤝 コントリビュート

これは実験的なプロジェクトであり、コントリビューションを歓迎します！問題に遭遇した場合や改善提案がある場合は、以下のことを行ってください。

• GitHubで問題を開く
• プルリクエストを送信する
• フィードバックとテスト結果を共有する

あなたの貢献により、このプロジェクトが皆のためにより良いものになります！

📄 ライセンス

このプロジェクトはApache License 2.0の下でライセンスされています。詳細については LICENSE ファイルを参照してください。