Sandbox MCP Server

基本能力

产品定位

Sandbox MCP Server 是一个为开发者和数据科学家提供的代码执行环境管理工具，支持多种编程语言的代码执行和开发环境配置。

核心功能

• 创建包含任何 Docker 镜像的容器
• 编写和执行多种编程语言的代码
• 安装包并设置开发环境
• 在隔离的容器中运行命令
• 创建持久化容器
• 保存容器状态为 Docker 镜像
• 生成 Dockerfile 以重现环境

适用场景

• 快速搭建和测试开发环境
• 数据科学和机器学习项目的环境配置
• 多语言代码的执行和测试
• 可重现的开发环境创建和共享

工具列表

1. create_container_environment: 创建带有指定镜像的新 Docker 容器
2. create_file_in_container: 在容器中创建文件
3. execute_command_in_container: 在容器中运行命令
4. save_container_state: 将容器状态保存为持久化容器
5. export_dockerfile: 导出 Dockerfile 以创建持久化环境
6. exit_container: 关闭容器以清理环境

常见问题解答

• 所有代码在隔离的 Docker 容器中执行
• 容器在使用后会自动移除
• 文件系统在容器之间是隔离的
• 主机系统访问受到限制

使用教程

使用依赖

• Python 3.9 或更高版本
• 已安装并运行的 Docker
• uv 包管理器（推荐）
• Docker MCP 服务器（推荐）

安装教程

1. 克隆仓库:

git clone <your-repo-url>
cd sandbox_server

1. 创建并激活虚拟环境:

uv venv
source .venv/bin/activate  # On Unix/MacOS
# Or on Windows:
# .venv\Scripts\activate

1. 安装依赖:

uv pip install .

集成 Claude Desktop

1. 打开 Claude Desktop 的配置文件:
2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

3. Windows: %APPDATA%\Claude\claude_desktop_config.json

4. 添加 sandbox 服务器配置:

{
    "mcpServers": {
        "sandbox": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/sandbox_server",
                "run",
                "sandbox_server.py"
            ],
            "env": {
                "PYTHONPATH": "/absolute/path/to/sandbox_server"
            }
        }
    }
}

1. 重启 Claude Desktop

调试方式

• 创建 Python 容器并编写简单的 hello world 程序
• 创建并运行计算斐波那契数列的 C 程序
• 创建使用 numpy 生成和绘制随机数据的 Python 脚本

许可证

None