MCP 服务器

MCP Code Sandbox Server

一个可扩展的消息通信协议服务器，可在隔离的沙箱环境中提供安全的代码执行能力，并与 Claude for Desktop 和其他 MCP 客户端兼容。

README

MCP 代码沙箱服务器

一个可扩展的消息通信协议 (MCP) 服务器，可在隔离的沙箱环境中提供安全的代码执行能力。此服务器遵循 MCP 标准，使其与 Claude for Desktop 和其他 MCP 客户端兼容。

特性

为代码执行创建隔离的沙箱环境
安全地执行 Python 代码
执行文件操作（列出、读取、写入）
在沙箱中安装 Python 包
具有抽象代码解释器接口的可扩展架构
具有清晰关注点分离的模块化设计

架构

该服务器采用模块化、可扩展的架构构建：

核心组件

抽象解释器接口：允许集成不同的代码执行后端
沙箱管理：用于创建和管理沙箱环境的工具
代码执行：用于运行代码和安装包的工具
文件操作：用于管理沙箱内文件的工具

项目结构

├── src/
│   └── sandbox/
│       ├── __pycache__/
│       ├── e2b/
│       │   ├── __pycache__/
│       │   ├── __init__.py
│       │   ├── e2b_file_interface.py
│       │   └── e2b_interpreter.py
│       ├── __init__.py
│       ├── code_interpreter.py
│       ├── file_interface.py
│       └── interpreter_factory.py
├── tools/
│   ├── __pycache__/
│   ├── __init__.py
│   ├── code_execution_tools.py
│   ├── file_tools.py
│   └── sandbox_tools.py
├── main.py
├── .env
├── .gitignore
├── .python-version
├── pyproject.toml
├── README.md
└── uv.lock

前提条件

Python 3.10 或更高版本
E2B API 密钥（对于默认的 E2B 解释器）

安装

克隆此存储库：

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

设置虚拟环境：

# 使用 venv
python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 或者使用 uv (推荐)
uv init
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

安装所需的包：

# 使用 pip
pip install fastmcp python-dotenv e2b-code-interpreter

# 或者使用 uv
uv add fastmcp python-dotenv e2b-code-interpreter

配置环境变量：

# 创建一个包含以下变量的 .env 文件
E2B_API_KEY=your_e2b_api_key_here
INTERPRETER_TYPE=e2b  # 默认，可以更改为其他已实现的解释器

用法

独立运行服务器

您可以直接从命令行运行服务器：

python main.py

这将使用 stdio 传输启动服务器，使其与 Claude for Desktop 兼容。

与 Claude for Desktop 一起使用

确保您已安装最新版本的 Claude for Desktop
打开您的 Claude for Desktop 配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

添加您的代码沙箱服务器配置：

{
  "mcpServers": {
    "code-sandbox": {
      "command": "python",
      "args": [
        "/ABSOLUTE/PATH/TO/main.py"
      ]
    }
  }
}

或者，如果您使用 uv：

{
  "mcpServers": {
    "code-sandbox": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PROJECT_DIRECTORY",
        "run",
        "main.py"
      ]
    }
  }
}

保存文件并重启 Claude for Desktop

可用工具

服务器提供以下工具：

沙箱管理

create_sandbox: 创建一个新的沙箱环境
close_sandbox: 关闭并清理沙箱
get_sandbox_status: 检查沙箱的状态

代码执行

execute_code: 在沙箱中运行 Python 代码
install_package: 安装一个 Python 包
create_run_close: 一体化工具，用于创建沙箱、运行代码和清理

文件操作

list_files: 列出沙箱中的文件
read_file: 读取文件的内容
write_file: 将内容写入文件
upload_file: 将文件上传到沙箱

使用新解释器扩展

该系统设计为可扩展的。要添加新的代码解释器：

在 src/sandbox/ 下为您的解释器实现创建一个新目录
实现 src/sandbox/code_interpreter.py 和 src/sandbox/file_interface.py 中定义的接口
将新的解释器类型添加到 src/sandbox/interpreter_factory.py
将环境变量 INTERPRETER_TYPE 配置为您的新解释器

实现新解释器的示例：

# src/sandbox/my_backend/my_interpreter.py
from src.sandbox.code_interpreter import CodeInterpreter, ExecutionResult
from src.sandbox.file_interface import FileInterface

class MyFileInterface(FileInterface):
    # 实现所需的方法
    
class MyInterpreter(CodeInterpreter):
    # 实现所需的方法

# 更新 src/sandbox/interpreter_factory.py 以包含您的新解释器