🚀 代码沙箱 MCP 🐳
代码沙箱 MCP 是一个基于 Docker 容器的安全隔离环境，专为 AI 应用程序中的代码执行而设计。借助容器化技术，该 MCP 服务器能提供安全且隔离的运行环境，有效保障代码运行时的安全性。
🚀 快速开始
代码沙箱 MCP 为 AI 应用程序提供了一个安全的代码执行环境。通过容器化技术，它能确保代码在独立的环境中运行，避免对主机系统造成影响。以下是使用该工具的基本步骤：
- 按照安装指南完成安装。
- 根据配置指南进行相应配置。
- 使用可用工具与代码沙箱 MCP 进行交互。
✨ 主要特性
- 灵活的容器管理：可创建和管理隔离的 Docker 容器，用于代码执行。
- 自定义环境支持：支持使用任何 Docker 镜像作为运行环境。
- 文件操作：能轻松实现主机与容器之间的文件目录传输。
- 命令执行：可在容器化环境中运行任意 shell 命令。
- 实时日志：支持实时流式处理容器日志和命令输出。
- 自动更新：内置更新检查和二进制文件自动更新功能。
- 多平台支持：适用于 Linux、macOS 和 Windows 系统。
📦 安装指南
先决条件
- 需安装并运行 Docker：
快速安装
在 Linux、macOS 或 Windows 上运行以下命令以下载并安装代码沙箱 MCP：
# 下载适用于 Linux/macOS 的二进制文件
wget https://github.com/Automata-Labs/code-sandbox-mcp/releases/download/v1.0.0/code-sandbox-mcp
# 或者下载适用于 Windows 的可执行文件
wget https://github.com/Automata-Labs/code-sandbox-mcp/releases/download/v1.0.0/code-sandbox-mcp.exe
# 为二进制文件设置可执行权限（仅限 Linux/macOS）
chmod +x code-sandbox-mcp
手动安装
若需手动构建代码沙箱 MCP，请参考 DEVELOPMENT.md。
🛠️ 可用工具
以下是可用于与代码沙箱 MCP 交互的命令行工具：
code-sandbox-mcp：主可执行文件，用于启动和管理代码沙箱服务。
工具参数
示例配置
{
"containerImage": "docker.io/library/ubuntu:latest",
"cpuQuota": 500,
"memoryLimit": "1G"
}
🛡️ 安全特性
- 隔离执行环境：所有代码均在独立的 Docker 容器中运行，可确保主机系统安全。
- 资源限制：通过 CPU 配额和内存限制来控制容器资源使用。
- 文件隔离：代码和数据仅在容器内部可见，可防止敏感信息泄露。
🎯 配置指南
在 Claude Desktop 上配置
安装程序会自动创建配置文件。若需手动配置，请参考以下示例：
Linux 系统
// ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"code-sandbox-mcp": {
"command": "/path/to/code-sandbox-mcp",
"args": [],
"env": {}
}
}
}
macOS 系统
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"code-sandbox-mcp": {
"command": "/path/to/code-sandbox-mcp",
"args": [],
"env": {}
}
}
}
Windows 系统
// %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"code-sandbox-mcp": {
"command": "C:\\path\\to\\code-sandbox-mcp.exe",
"args": [],
"env": {}
}
}
}
其他 AI 应用程序
对于支持 MCP 服务器的其他 AI 应用程序，请配置它们将 code-sandbox-mcp 可执行文件作为代码执行后端。
🚀 开发
若需本地构建项目或参与开发，请参考 DEVELOPMENT.md。
📄 许可证
此项目采用 MIT 许可证，详细信息请参阅 LICENSE 文件。