MCP Code Sandbox Server

基本能力

产品定位

MCP Code Sandbox Server 是一个用于安全执行代码的沙盒环境服务器，适用于开发测试和自动化脚本执行场景。

核心功能

• 创建隔离的沙盒环境
• 安全执行 Python 代码
• 进行文件操作（列出、读取、写入）
• 在沙盒中安装 Python 包
• 可扩展的架构，支持不同的代码解释器后端
• 模块化设计，职责分离清晰

适用场景

• 开发过程中的代码测试
• 自动化脚本执行
• 需要隔离环境的代码运行

工具列表

沙盒管理

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

代码执行

• execute_code: 在沙盒中运行 Python 代码
• install_package: 安装 Python 包
• create_run_close: 一站式工具，创建沙盒、运行代码并清理

文件操作

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

常见问题解答

• 确保有正确的 API 密钥
• 检查日志获取详细错误信息
• 验证所有必需的包是否已安装
• 确保 Claude for Desktop 配置了正确的脚本路径

使用教程

使用依赖

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

安装教程

1. 克隆仓库： bash git clone https://github.com/yourusername/mcp-code-sandbox.git cd mcp-code-sandbox

2. 设置虚拟环境： ```bash # 使用 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 ```

1. 安装所需包： ```bash # 使用 pip pip install fastmcp python-dotenv e2b-code-interpreter

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

1. 配置环境变量： # 创建 .env 文件并添加以下变量 E2B_API_KEY=your_e2b_api_key_here INTERPRETER_TYPE=e2b # 默认，可更改为其他实现的解释器

调试方式

运行服务器：

python main.py

与 Claude for Desktop 集成： 1. 确保安装了最新版本的 Claude for Desktop 2. 打开配置文件： - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json 3. 添加代码沙盒服务器配置 4. 保存文件并重启 Claude for Desktop

许可证

该项目遵循 MIT 开源许可条款。