MCP Sandbox

可在 mcp sandbox 上尝试

项目概述

mcp-sandbox 是一个基于 Docker 的安全沙盒环境，专为运行和管理 Python 代码设计。它通过容器化技术提供隔离的执行环境，确保每个任务独立运行，互不影响。该工具支持安装和管理 Python 包，并能够处理生成的各种文件类型（如图像、CSV 等），并通过 HTTP 链接方便地访问这些文件。

主要功能

• Docker 隔离：每个执行的任务都在独立的 Docker 容器中运行，确保环境安全。
• 包管理：支持安装和管理常用的 Python 包（如 numpy、pandas 等）。
• 文件处理：能够生成和存储各种文件类型，并通过 HTTP 链接直接访问。

安装步骤

1. 克隆仓库：

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

2. 进入项目目录：

   cd mcp-sandbox
   

3. 启动服务：

   npm run dev
   

可用工具

以下是可用的主要工具及其功能描述：

• list_sandboxes()：列出所有现有的沙盒环境。
• create_sandbox()：创建一个新的沙盒环境，返回新的 sandbox_id。
• delete_sandbox(sandbox_id)：删除指定的沙盒环境。
• install_package(sandbox_id, package_name)：在指定的沙盒中安装指定的 Python 包。
• check_install_status(sandbox_id, package_name)：检查指定包的安装状态。
• execute_code(sandbox_id, code)：在指定的沙盒中执行提供的 Python 代码，返回输出、错误和生成文件的链接。

示例工作流程

1. 使用 list_sandboxes() 检查可用的沙盒环境。如果没有可用沙盒，使用 create_sandbox() 创建一个新的，获取 sandbox_id。
2. 使用 install_package(sandbox_id, package_name) 安装所需的包（如 numpy、pandas 等）。
3. 使用 check_install_status(sandbox_id, package_name) 验证包的安装状态。如果正在安装中，请稍后再次检查。
4. 使用 execute_code(sandbox_id, code) 执行代码，返回输出、错误和生成文件的链接。

MCP 示例配置

以下是一个适用于 Claude 的示例配置：

{
  "mcpServers": {
    "mcpSandbox": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse",  "http://localhost:8000/sse"]
    }
  }
}

在线演示的 MCP 示例配置

{
  "mcpServers": {
    "mcpSandbox": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse",  "http://115.190.87.78/sse?api_key=<API_KEY>"]
    }
  }
}

根据您的环境，可能需要调整 serverUrl。