沙盒 MCP 服务器

一个 MCP 服务器，提供隔离的 Docker 环境以执行代码。此服务器允许您：

• 使用任意 Docker 镜像创建容器

• 使用多种编程语言编写和执行代码

• 安装软件包并设置开发环境

• 在隔离的容器中运行命令

先决条件

• Python 3.9 或更高版本

• Docker 安装并运行

• uv 包管理器（推荐）

• Docker MCP 服务器（推荐）

安装

1. 克隆此存储库：

2. 使用 uv 创建并激活虚拟环境：

3. 安装依赖项：

与 Claude Desktop 集成

1. 打开Claude Desktop的配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows： %APPDATA%\Claude\claude_desktop_config.json

2. 添加沙盒服务器配置：

将/absolute/path/to/sandbox_server替换为项目目录的实际路径。

3. 重启Claude桌面

使用示例

基本用法

一旦连接到 Claude Desktop，您可以：

1. 创建 Python 容器：

2. 以不同的语言运行代码：

3. 安装包并使用它们：

保存和重现环境

服务器提供了几种保存和重现开发环境的方法：

创建持久容器

创建容器时，您可以使其持久化：

这将创建一个容器：

• Claude Desktop 关闭后仍继续运行

• 可以通过Docker直接访问

• 保留所有已安装的软件包和文件

服务器将提供以下说明：

• 直接访问容器（ docker exec ）

• 停止和启动容器

• 不再需要时删除

保存容器状态

设置好环境后，您可以将其保存为 Docker 镜像：

这将：

1. 创建一个新的 Docker 镜像，其中包含以下内容：

   • 已安装的软件包

   • 创建的文件

   • 配置更改

2. 提供重复使用环境的说明

然后，您可以共享此图像或将其用作新容器的起点：

生成 Dockerfile

为了使您的环境完全可重现，您可以生成一个 Dockerfile：

生成的 Dockerfile 将包括：

• 基础镜像规范

• 创建的文件

• 附加设置步骤的模板

您可以使用此 Dockerfile 来执行以下操作：

1. 与他人共享您的环境设置

2. 版本控制您的开发环境

3. 修改和定制构建过程

4. 部署到不同的系统

推荐的工作流程

对于可重复的开发环境：

1. 创建持久容器：

2. 安装所需的软件包并设置环境：

3. 测试您的设置：

4. 保存状态：

5. 导出 Dockerfile：

这为您提供了重新创建环境的多种选择：

• 直接使用保存的Docker镜像

• 通过修改 Dockerfile 进行构建

• 如果需要，可以访问原始容器

安全说明

• 所有代码都在隔离的 Docker 容器中执行

• 容器使用后自动移除

• 容器之间的文件系统是隔离的

• 主机系统访问受到限制

项目结构

可用工具

该服务器提供三个主要工具：

1. create_container_environment ：使用指定的镜像创建一个新的 Docker 容器

2. create_file_in_container ：在容器中创建文件

3. execute_command_in_container ：在容器中运行命令

4. save_container_state ：将容器状态保存到持久容器

5. export_dockerfile ：导出docker文件以创建持久环境

6. exit_container ：完成后关闭容器以清理环境