MCP Code Sandbox Server

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解释器）

安装

1. 克隆此存储库：

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

1. 设置虚拟环境：

   # Using venv
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

   # Or using uv (recommended)
   uv init
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

1. 安装所需的软件包：

   # Using pip
   pip install fastmcp python-dotenv e2b-code-interpreter

   # Or using uv
   uv add fastmcp python-dotenv e2b-code-interpreter

1. 配置环境变量：

   # Create a .env file with the following variables
   E2B_API_KEY=your_e2b_api_key_here
   INTERPRETER_TYPE=e2b  # Default, can be changed to other implemented interpreters

用法

独立运行服务器

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

python main.py

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

使用Claude for Desktop

1. 确保您安装了最新版本的Claude for Desktop

1. 打开Claude for Desktop配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 添加您的代码沙盒服务器配置：

   {
     "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"
         ]
       }
     }
   }

1. 保存文件并重新启动Claude for Desktop

可用工具

服务器提供以下工具：

沙盒管理

• create_sandbox：创建新的沙盒环境
• 关闭沙箱：关闭并清理沙箱
• get_sandbox_status：检查沙盒的状态

代码执行

• execute_code：在沙盒中运行Python代码
• 安装包：安装Python包
• create_run_close：创建沙箱、运行代码和清理的多功能工具

文件操作

• 列表文件：列出沙盒中的文件
• read_file：读取文件内容
• write_file：将内容写入文件
• 上传文件：将文件上传到沙盒

与新口译员一起扩展

该系统被设计为可扩展的。要添加新的代码解释器，请执行以下操作：

1. 在下创建新目录 src/sandbox/ 用于您的解释器实现
2. 实现中定义的接口 src/sandbox/code_interpreter.py 和 src/sandbox/file_interface.py
3. 将新的解释器类型添加到 src/sandbox/interpreter_factory.py
4. 配置环境变量 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):
    # Implement the required methods
    
class MyInterpreter(CodeInterpreter):
    # Implement the required methods

# Update src/sandbox/interpreter_factory.py to include your new interpreter

模块说明

沙盒核心(src/sandbox/)

• code_interpreter.py：代码解释器的抽象基类
• file_interface.py：文件操作的抽象接口
• interpreter_factory.py：用于创建代码解释器实例的工厂

E2B实施(src/sandbox/e2b/)

• e2b_interpreter.py：代码解释器的E2B实现
• e2b_file_interface.py：文件操作的E2B实现

工具(tools/)

• sandbox_tools.py：沙盒管理工具
• code_execution_tools.py：代码执行工具
• file_tools.py：文件操作工具

主要应用

• main.py：主要应用程序入口点

故障排除

如果您遇到问题：

• 确保您有正确的API密钥用于您选择的解释器
• 检查日志以了解详细的错误消息
• 验证是否安装了所有必需的软件包
• 确保Claude for Desktop配置了正确的脚本路径

安全考虑

• 为了安全起见，代码执行发生在沙盒环境中
• 请勿在生产环境中使用此服务器执行不受信任的代码
• 服务器当前未实现身份验证-它只应在受信任的环境中使用

许可证

MIT许可证