Windowssandboxmcp

🚀 Windows Sandbox MCP

Windows Sandbox MCP 是一個 .NET 工具，可通過模型 - 視圖 - 控制器（MCP）協議管理 Windows 沙盒實例，為 Windows 沙盒的使用提供了便捷的編程控制方式。

Demo

⚠️ 重要提示

本項目目前處於實驗階段，可能存在漏洞和限制。我們歡迎反饋和測試，但不建議在生產環境中使用。請報告問題並提供反饋，以幫助改進項目！

🚀 快速開始

環境要求

⚠️ 重要提示：此工具需要 Windows 11 24H2 或更高版本，在 Windows 10 或早期版本的 Windows 11 上無法使用。

此 MCP 服務器依賴於新的 Windows 沙盒架構和 wsb.exe CLI 工具，這些僅在 Windows 11 24H2 及更高版本中可用。

• Windows 11 24H2 或更高版本（必需）
• .NET 10.0 SDK
• Windows 沙盒

構建項目

dotnet build

📦 安裝指南

與 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 許可證 2.0 - 詳情請參閱 LICENSE 文件。