Python 沙箱 MCP 服务器

一个安全的 Python 代码执行服务器，允许大语言模型（LLMs）在隔离的 Docker 容器中安全地运行 Python 代码。该服务器支持：

• 带有标准输出捕获的常规 Python 代码执行
• 使用 PNG 图像生成的 Matplotlib 绘图
• 通过 Snekbox Docker 容器进行的安全沙箱
• 使用服务器发送事件（SSE）进行实时通信

开发

要开始开发，请按照以下步骤操作：

第一步：克隆仓库

分叉并克隆仓库：

git clone https://github.com/username/python_sandbox_mcp_server.git

进入项目目录：

cd python_sandbox_mcp_server

第二步：安装依赖项

安装所需的依赖项：

pip install -r requirements.txt

第三步：构建 Python 沙箱

拉取 Snekbox 容器镜像：

docker pull ghcr.io/python-discord/snekbox:latest

使用安全参数启动容器：

docker run -d --ipc=none --privileged -p 8060:8060 ghcr.io/python-discord/snekbox

安装额外的依赖项（可选）：

• 如果需要额外的 Python 包，可以按如下方式安装：

docker exec <container_id> /bin/sh -c \
    'PYTHONUSERBASE=/snekbox/user_base /snekbox/python/default/bin/python -m pip install --user <package_name>'

• 将 <container_id> 替换为您正在运行的 Snekbox 容器的 ID，并将 <package_name> 替换为所需的包。

第四步：更新 MCP 服务器配置

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

{
  "mcpServers": {
    "python-sandbox-sse": {
      "command": "mcp-proxy",
      "args": [
        "http://localhost:8060/eval"
      ],
      "ssePath": "/eval"
    }
  }
}

配置

服务器可以通过环境变量或修改 Config 类来配置：

• MCP_SERVER_NAME：服务器标识符（默认："python-sandbox-mcp-sse"）
• SNEKBOX_URL：Snekbox API 端点（默认："http://localhost:8060/eval"）
• TEMP_DIR：临时文件存储目录

许可证

MIT 许可证