Sandbox MCP

🚀 砂箱 MCP 介绍

砂箱 MCP 是一款模型上下文协议（MCP）服务器，它允许大型语言模型（LLM，也就是 MCP 主机/客户端）在 安全隔离的 Docker 容器中运行代码。

虽然大型语言模型在代码生成方面表现卓越，但大多数 无法执行它们所生成的代码。这就导致你可能会直接在机器上运行未经测试的代码，从而引发严重的意外后果。

而砂箱 MCP 赋予了大型语言模型安全测试代码的能力，不仅能避免此类问题，还能帮助你 更快地生成更准确的代码。它为大型语言模型提供了一个 易于使用的执行环境，任何人都可以通过简单、AI 原生的 MCP 服务器在本地创建和配置。

• 本项目受 Codapi 启发，部分砂箱与 Codapi 砂箱 相同。

🚀 快速开始

演示

此演示展示了砂箱 MCP 如何与 Claude Desktop 一起使用：

如果 GIF 不清晰，请尝试观看视频 demo.mp4。

📦 安装指南

下载二进制文件

您可以从 发布页面 下载适合您操作系统（例如 Darwin）和处理器架构（如 arm64）的二进制文件（例如：sandbox-mcp_Darwin_arm64.tar.gz）。

使用 Go 安装

先决条件：

• Go 1.24 或更高版本

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

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

which sandbox-mcp

从源代码构建

请参见 开发部分。

💻 使用示例

初始化

在使用 sandbox-mcp 与 LLM 之前，需要初始化其配置：

# 创建配置目录 $XDG_CONFIG_HOME/sandbox-mcp 并从 GitHub 拉取
# 默认砂箱
sandbox-mcp --pull

# 构建砂箱的 Docker 镜像
sandbox-mcp --build

⚠️ 重要提示

请确保已安装并运行 Docker。

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

将以下内容添加到您的 claude_desktop_config.json（适用于 Claude Desktop）或 mcp.json（适用于 Cursor IDE）中：

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

⚠️ 重要提示

请将 path/to/sandbox-mcp 替换为实际的 sandbox-mcp 二进制文件路径。

📚 详细文档

可用砂箱

shell

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

python

在一个预装了特定库的环境中运行 Python 代码。

⚠️ 重要提示

您可以创建自己的砂箱以支持更多语言或工具，例如 Go、Java 或 SQL。

network_tools

在受限制的网络环境中安全地执行网络相关任务。

开发

# 叉取仓库并切换到项目目录
git clone https://github.com/pottekkat/sandbox-mcp.git && cd sandbox-mcp

# 安装依赖项
npm install

# 构建 Docker 镜像（位于 `docker/` 目录中）
docker build -t sandbox-mcp .

# 运行测试
npm test

砂箱 MCP 为安全执行 LLM 生成的代码提供了一个可靠的方法，对开发者和普通用户都有一定的价值。