🚀 代码沙盒MCP 🐳
一个基于Docker容器的安全沙盒环境，用于在AI应用程序中执行代码。此MCP服务器借助容器化技术，提供安全且隔离的环境，保障代码运行时的安全性。
🚀 快速开始
代码沙盒MCP是一个基于Docker容器的安全沙盒环境，可用于在AI应用程序中执行代码。你可以按照以下步骤快速安装和使用它。
✨ 主要特性
- 灵活的容器管理：创建和管理用于代码执行的独立Docker容器。
- 自定义环境支持：使用任何Docker镜像作为执行环境。
- 文件操作：轻松实现主机与容器之间的文件和目录传输。
- 命令执行：在容器化环境中运行任意shell命令。
- 实时日志：实时流式处理容器日志和命令输出。
- 自动更新：内置更新检查及二进制文件自动更新功能。
- 多平台支持：适用于Linux、macOS和Windows。
📦 安装指南
先决条件
- Docker已安装并运行：
快速安装
Linux、macOS
curl -fsSL https://raw.githubusercontent.com/Automata-Labs/code-sandbox-mcp/main/install.sh | bash
Windows
iwr https://raw.githubusercontent.com/Automata-Labs/code-sandbox-mcp/main/install.ps1 -UseBasicParsing | invoke-Expression
手动安装
将code-sandbox-mcp可执行文件下载到目标目录，并确保其具有可执行权限（对于Unix系统）。
💻 使用示例
基础用法
1. 初始化沙盒环境
code-sandbox-mcp initialize --config ./config.json
2. 启动沙盒服务
code-sandbox-mcp start --bind 0.0.0.0:8080
3. 停止沙盒服务
code-sandbox-mcp stop
4. 查看容器状态
code-sandbox-mcp ps
📚 详细文档
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即可。
🔧 技术细节
- 隔离执行环境：每个任务在独立的Docker容器中运行，防止资源竞争和逃逸攻击。
- 资源限制：设置CPU、内存使用上限，确保系统稳定性和性能。
🚀 开发指南
如需本地构建项目或参与开发，请参阅DEVELOPMENT.md。
📄 许可证
本项目采用MIT License协议。详细信息请参考LICENSE文件。