Sandbox MCP

Sandbox MCP 是一个模型上下文协议（MCP）服务器，它允许大型语言模型（MLP主机/客户端）在安全、隔离的Docker容器中运行代码和配置。

虽然大型语言模型非常擅长生成代码，但大多数无法运行它们生成的代码。这可能导致你在自己的机器上直接运行未经测试的代码，从而可能产生意想不到的后果。

Sandbox MCP 为这些模型提供了一个易于使用的执行环境，任何人都可以通过一个简单的、基于AI原生的本地运行的MCP服务器来创建和配置这个环境。

灵感来源于 Codapi。部分沙箱与 Codapi 沙箱相同。

演示

下面的演示展示了MCP如何与Claude Desktop协同工作。如果下面的GIF不够清晰，请参见视频。

安装

下载二进制文件

你可以从“Releases”页面下载并使用适合你操作系统和处理器架构的相应二进制文件。

通过Go安装

先决条件：

• Go 1.24 或更高版本

go install github.com/pottekkat/sandbox-mcp/cmd/sandbox-mcp@latest

获取到 sandbox-mcp 二进制文件的路径：

which sandbox-mcp

从源码构建

请参阅下方的开发部分。

使用

初始化

在使用 sandbox-mcp 与大型语言模型之前，你需要初始化其配置：

# Create the configuration directory and
# pull the default sandboxes from GitHub
sandbox-mcp --pull

# Build the Docker images for the sandboxes
sandbox-mcp --build

[!NOTE]
确保已安装并正在运行 Docker。

与MCP主机/客户端一起使用

对于Claude Desktop，在你的 claude_desktop_config.json 文件中添加如下内容；对于Cursor，则在 mcp.json 中添加：

{
    "mcpServers": {
        "sandbox-mcp": {
            "command": "path/to/sandbox-mcp",
            "args": [
                "--stdio"
            ]
        }
    }
}

[!NOTE]
确保将 path/to/sandbox-mcp 替换为实际的 sandbox-mcp 二进制文件路径。

可用沙箱

shell

在一个具有严格安全性和网络限制的Linux环境中运行shell命令。

python

运行带有预装库集的Python代码。

[!IMPORTANT]

创建你自己的沙箱

你可以通过在 sandboxes 目录下以沙箱名称新建一个目录，并向其中添加 Dockerfile 和 config.json 来创建自己的沙箱。请参见 /sandboxes/ 获取示例。

network-tools

在一个隔离的Linux沙箱中使用各种网络工具。该容器具有网络访问权限。

查看 jonlabelle/docker-network-tools 获取可用工具列表。

go

在一个隔离的沙箱中运行简单的Go代码。

javascript

使用Node.js运行JavaScript代码。

开发

分叉并克隆仓库：

git clone https://github.com/username/sandbox-mcp.git

切换到目录：

cd sandbox-mcp

安装依赖项：

make deps

构建项目：

make build

更新你的MCP服务器配置以指向本地构建：

{
    "mcpServers": {
        "sandbox-mcp": {
            "command": "/path/to/sandbox-mcp/dist/sandbox-mcp",
            "args": [
                "--stdio"
            ]
        }
    }
}

许可证

MIT许可证