Code Sandbox

🚀 代码沙盒MCP 🐳

一个基于Docker容器的安全沙盒环境，用于在AI应用程序中执行代码。此MCP服务器借助容器化技术，提供安全且隔离的环境，保障代码运行时的安全性。

🚀 快速开始

代码沙盒MCP是一个基于Docker容器的安全沙盒环境，可用于在AI应用程序中执行代码。你可以按照以下步骤快速安装和使用它。

✨ 主要特性

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

📦 安装指南

先决条件

• Docker已安装并运行：
  • 在Linux上安装Docker
  • 在macOS上安装Docker Desktop
  • 在Windows上安装Docker Desktop

快速安装

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文件。