MCP 服务器

Code Sandbox MCP

一个 MCP 服务器，用于创建安全的代码沙箱环境，以便在 Docker 容器中执行代码。

README

Code Sandbox MCP 🐳

一个安全的沙箱环境，用于在 Docker 容器中执行代码。此 MCP 服务器为 AI 应用程序提供了一个安全且隔离的环境来运行代码，同时通过容器化保持安全性。

🌟 特性

灵活的容器管理: 创建和管理用于代码执行的隔离 Docker 容器
自定义环境支持: 使用任何 Docker 镜像作为您的执行环境
文件操作: 主机和容器之间轻松进行文件和目录传输
命令执行: 在容器化环境中运行任何 shell 命令
实时日志: 实时流式传输容器日志和命令输出
自动更新: 内置更新检查和自动二进制更新
多平台: 支持 Linux、macOS 和 Windows

🚀 安装

前提条件

Docker 已安装并运行

快速安装

Linux, MacOS

curl -fsSL https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.sh | bash

Windows

# 在 PowerShell 中运行
irm https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.ps1 | iex

安装程序将：

检查 Docker 是否已安装
下载适合您系统的二进制文件
创建必要的配置文件

手动安装

从发布页面下载适用于您平台的最新版本
将二进制文件放置在 PATH 中的目录中
使其可执行（仅限类 Unix 系统）：
```
chmod +x code-sandbox-mcp
```

🛠️ 可用工具

`sandbox_initialize`

初始化一个新的计算环境以执行代码。基于指定的 Docker 镜像创建一个容器。

参数：

image (字符串，可选): 用作基础环境的 Docker 镜像
- 默认值: 'python:3.12-slim-bookworm'

返回值：

container_id，可与其他工具一起使用以与此环境交互

`copy_project`

将目录复制到沙盒文件系统。

参数：

container_id (字符串，必需): 从初始化调用返回的容器 ID
local_src_dir (字符串，必需): 本地文件系统中目录的路径
dest_dir (字符串，可选): 将 src 目录保存在沙箱环境中的路径

`write_file`

将文件写入沙盒文件系统。

参数：

container_id (字符串，必需): 从初始化调用返回的容器 ID
file_name (字符串，必需): 要创建的文件名
file_contents (字符串，必需): 要写入文件的内容
dest_dir (字符串，可选): 在其中创建文件的目录 (默认值: ${WORKDIR})

`sandbox_exec`

在沙盒环境中执行命令。

参数：

container_id (字符串，必需): 从初始化调用返回的容器 ID
commands (数组，必需): 要在沙盒环境中运行的命令列表
- 示例: ["apt-get update", "pip install numpy", "python script.py"]

`copy_file`

将单个文件复制到沙盒文件系统。

参数：

container_id (字符串，必需): 从初始化调用返回的容器 ID
local_src_file (字符串，必需): 本地文件系统中文件的路径
dest_path (字符串，可选): 将文件保存在沙箱环境中的路径

`sandbox_stop`

停止并删除正在运行的容器沙箱。

参数：

container_id (字符串，必需): 要停止和删除的容器 ID

描述： 使用 10 秒超时时间正常停止指定的容器，并将其及其卷一起删除。

容器日志资源

一种动态资源，提供对容器日志的访问。

资源路径： containers://{id}/logs MIME 类型： text/plain 描述： 将指定容器中的所有容器日志作为单个文本资源返回。

🔐 安全特性

使用 Docker 容器的隔离执行环境
通过 Docker 容器约束的资源限制
单独的 stdout 和 stderr 流

🔧 配置

Claude Desktop

安装程序会自动创建配置文件。如果您需要手动配置它：

Linux

// ~/.config/Claude/claude_desktop_config.json
{
    "mcpServers": {
        "code-sandbox-mcp": {
            "command": "/path/to/code-sandbox-mcp",
            "args": [],
            "env": {}
        }
    }
}

macOS

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
    "mcpServers": {
        "code-sandbox-mcp": {
            "command": "/path/to/code-sandbox-mcp",
            "args": [],
            "env": {}
        }
    }
}

Windows

// %APPDATA%\Claude\claude_desktop_config.json
{
    "mcpServers": {
        "code-sandbox-mcp": {
            "command": "C:\\path\\to\\code-sandbox-mcp.exe",
            "args": [],
            "env": {}
        }
    }
}