Windows Sandbox MCP

Windows Sandbox MCP（注：MCP在此处可能是一个特定上下文或品牌中的缩写或特定术语，没有通用的中文翻译，因此直接保留原样。如果MCP在特定上下文中有所指代，如“微软认证专家”等，则需根据具体上下文进行翻译。）

 ](https://www.nuget.org/packages/WindowsSandboxMcp/)

A.通过模型-视图-控制器（MVC）协议管理Windows Sandbox实例的.NET工具。


⚠️ 实验性项目 这个项目目前正处于实验阶段。它可能包含错误和局限性。我们欢迎反馈和测试，但 不建议在生产环境中使用 此时。 请报告问题并提供反馈，以帮助改进项目！

要求

⚠️ 重要提示： 这个工具需要 Windows 11 24H2或更高版本它不适用于Windows 10或Windows 11的早期版本。

这个MCP服务器依赖于新的Windows Sandbox架构和 wsb.exe CLI 工具，仅在 Windows 11 24H2 及更高版本中可用。

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

构建

dotnet build

用法

这个MCP服务器可以与任何兼容MCP的客户端一起使用，包括Claude Desktop和VS Code。

使用 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"]
    }
  }
}

你必须使用绝对路径。你可以使用以下方法检查项目的绝对路径： pwd 在 PowerShell 中的命令。

你必须使用绝对路径。你可以使用以下方法检查项目的绝对路径： pwd 在 PowerShell 中的命令。

3. 重启Claude桌面版

保存配置文件后， 完全关闭 关闭 Claude Desktop 并重新启动它。

右键点击系统托盘中的Claude图标，并选择“退出”

可用功能

此MCP服务器通过以下功能提供对Windows Sandbox的程序化控制：

• 沙盒生命周期管理 - 启动和停止带有自定义配置的 Windows Sandbox 实例
• 命令执行 - 在沙盒环境中执行命令和脚本
• 共享文件夹 - 将主机目录映射到沙箱以实现文件共享
• 网络信息 - 获取网络配置和IP地址
• 会话管理 - 连接到并监控沙盒会话
• 状态监控 - 检查当前是否正在运行沙盒

注： 随着项目的进展，可用工具及其参数可能会发生变化。请使用您的MCP客户端的工具发现功能来查看当前可用工具及其规范的列表。

使用方法/用法

你可以向Claude Desktop提出以下问题：

• “启动一个新的 Windows 沙盒”
• “在沙箱中执行记事本”
• “获取沙盒的网络信息”
• “停止沙盒（监管）”
• “在沙盒中添加共享文件夹”
• “当前是否有沙盒正在运行？”

技术细节

建筑学

这个MCP服务器使用了Windows 11 24H2版本中引入的新Windows Sandbox架构，该架构通过（某种方式）提供程序化控制 wsb.exe 命令行界面（CLI）工具。

依赖项：

• 模型上下文协议 (v0.4.0-preview.3) - 核心MCP实现
• Microsoft.Extensions.Hosting (v10.0.0) - 应用程序托管基础设施
• System.Management（系统管理） (v10.0.0) - 进程管理的WMI（Windows Management Instrumentation）集成
• \wsb.exe\ 可以翻译为“wsb可执行文件”或根据上下文简化为“wsb程序”。不过，具体翻译可能还需要根据\wsb.exe\的实际用途和上下文来确定更准确的表述。在没有特定上下文的情况下，“wsb可执行文件”是一个较为通用的翻译 - Windows Sandbox CLI 工具（Windows 11 24H2+ 版本内置）

项目结构

• Program.cs - 入口点和MCP服务器初始化
• WindowsSandbox.cs 高级Windows Sandbox API
• WindowsSandboxCliRaw.cs - 低级命令行界面（CLI）封装
• Tools/WindowsSandboxTools.cs - MCP工具定义
• Models/ - 配置和数据模型

主要特点

• 单个沙盒实例管理（防止多个沙盒同时运行）
• 自动连接和就绪状态检测
• 远程会话窗口管理
• 基于WMI的活动会话进程检测

做出贡献

这是一个实验性项目，我们欢迎各方贡献！如果您遇到任何问题或有改进建议，请：

• 在GitHub上打开一个问题（或提交一个issue）
• 提交拉取请求
• 分享您的反馈和测试结果

大家的贡献有助于让这个项目对每个人都有更好的帮助！

许可证

这个项目采用Apache License 2.0授权 - 详见 许可证 请查阅文件以获取详细信息。