Code Sandbox MCP 🐳

基本能力

产品定位

Code Sandbox MCP 是一个用于代码执行的沙箱环境，特别适合需要安全隔离环境的 AI 应用程序。

核心功能

• 灵活的容器管理：创建和管理用于代码执行的隔离 Docker 容器
• 自定义环境支持：使用任何 Docker 镜像作为执行环境
• 文件操作：轻松在主机和容器之间传输文件和目录
• 命令执行：在容器化环境中运行任何 shell 命令
• 实时日志：实时流式传输容器日志和命令输出
• 自动更新：内置更新检查和自动二进制更新
• 多平台支持：支持 Linux、macOS 和 Windows

适用场景

• AI 应用程序需要安全执行用户代码
• 开发环境隔离测试
• 自动化构建和测试流程

工具列表

• sandbox_initialize：初始化一个新的计算环境
• copy_project：将目录复制到沙箱文件系统
• write_file：将文件写入沙箱文件系统
• sandbox_exec：在沙箱环境中执行命令
• copy_file：将单个文件复制到沙箱文件系统
• sandbox_stop：停止并移除运行的容器沙箱
• Container Logs Resource：提供对容器日志的访问

常见问题解答

• 确保 Docker 已安装并运行
• 安装过程中会自动检查 Docker 安装
• 支持多平台安装（Linux、macOS、Windows）

使用教程

使用依赖

• Docker 必须已安装并运行
• Linux 安装 Docker
• macOS 安装 Docker Desktop
• Windows 安装 Docker Desktop

安装教程

Linux, MacOS

curl -fsSL https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.sh | bash

Windows

# Run in PowerShell
irm https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.ps1 | iex

调试方式

1. 检查 Docker 是否运行
2. 运行 code-sandbox-mcp 命令查看是否正常工作
3. 使用 sandbox_initialize 工具测试容器创建
4. 检查日志输出是否有错误信息

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。