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- 设置虚拟环境：
# 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- 安装所需的软件包：
# Using pip
pip install fastmcp python-dotenv e2b-code-interpreter
# Or using uv
uv add fastmcp python-dotenv e2b-code-interpreter- 配置环境变量：
# 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
- 确保您安装了最新版本的Claude for Desktop
- 打开Claude for Desktop配置文件：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %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：创建新的沙盒环境
- 关闭沙箱：关闭并清理沙箱
- get_sandbox_status：检查沙盒的状态
代码执行
- execute_code：在沙盒中运行Python代码
- 安装包：安装Python包
- create_run_close：创建沙箱、运行代码和清理的多功能工具
文件操作
- 列表文件：列出沙盒中的文件
- read_file：读取文件内容
- write_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):
# 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配置了正确的脚本路径
安全考虑
- 为了安全起见，代码执行发生在沙盒环境中
- 请勿在生产环境中使用此服务器执行不受信任的代码
- 服务器当前未实现身份验证-它只应在受信任的环境中使用