Docker 컨테이너 내에서 코드를 실행할 수 있는 안전한 샌드박스 환경입니다. 이 MCP 서버는 컨테이너화를 통해 보안을 유지하면서 AI 애플리케이션에 안전하고 격리된 환경을 제공합니다.

🌟 특징

• 유연한 컨테이너 관리: 코드 실행을 위한 독립된 Docker 컨테이너 생성 및 관리
• 커스텀 환경 지원: 실행 환경으로 원하는 도커 이미지를 사용할 수 있습니다
• 파일 작업: 호스트와 컨테이너 간 파일 및 디렉터리 전송이 용이합니다
• 명령 실행: 컨테이너화된 환경 내에서 모든 셸 명령을 실행합니다
• 실시간 로깅: 컨테이너 로그와 명령 출력 스트림
• 자동 업데이트: 내장 업데이트 검사 및 자동 이진 업데이트
• 멀티플랫폼: Linux, macOS, Windows 지원

🚀 설치

전제 조건

• Docker 설치 및 실행 중
• Linux용 Docker 설치
• macOS용 도커 데스크톱 설치
• Windows 용 도커 데스크톱 설치

빠른 설치

리눅스, 맥OS

창문

설치자는 다음과 같은 일을 할 것입니다:

1. Docker 설치 확인
2. 시스템에 맞는 바이너리 다운로드
3. 필요한 구성 파일 생성

수동 설치

Code Sandbox MCP 🐳

A secure sandbox environment for executing code within Docker containers. This MCP server provides AI applications with a safe and isolated environment for running code while maintaining security through containerization.

🌟 Features

• Flexible Container Management: Create and manage isolated Docker containers for code execution
• Custom Environment Support: Use any Docker image as your execution environment
• File Operations: Easy file and directory transfer between host and containers
• Command Execution: Run any shell commands within the containerized environment
• Real-time Logging: Stream container logs and command output in real-time
• Auto-Updates: Built-in update checking and automatic binary updates
• Multi-Platform: Supports Linux, macOS, and Windows

🚀 Installation

Prerequisites

• Docker installed and running
  • Install Docker for Linux
  • Install Docker Desktop for macOS
  • Install Docker Desktop for Windows

Quick Install

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

The installer will:

1. Check for Docker installation
2. Download the appropriate binary for your system
3. Create necessary configuration files

Manual Installation

1. Download the latest release for your platform from the releases page
2. Place the binary in a directory in your PATH
3. Make it executable (Unix-like systems only):

   chmod +x code-sandbox-mcp
   

🛠️ Available Tools

sandbox_initialize

Initialize a new compute environment for code execution. Creates a container based on the specified Docker image.

Parameters:

• image (string, optional): Docker image to use as the base environment
  • Default: ‘python:3.12-slim-bookworm’

Returns:

• container_id that can be used with other tools to interact with this environment

copy_project

Copy a directory to the sandboxed filesystem.

Parameters:

• container_id (string, required): ID of the container returned from the initialize call
• local_src_dir (string, required): Path to a directory in the local file system
• dest_dir (string, optional): Path to save the src directory in the sandbox environment

write_file

Write a file to the sandboxed filesystem.

Parameters:

• container_id (string, required): ID of the container returned from the initialize call