local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Executes code within isolated Docker containers for secure sandboxed environments, with support for Python, Go, and Node.js code execution and dependency management.
Supports running Node.js code and projects with automatic dependency detection via require/import statements and package.json, including built-in TypeScript support.
Allows execution of Python code snippets and projects with automatic dependency detection and installation via pip, requirements.txt, pyproject.toml, or setup.py.
코드 샌드박스 MCP 🐳
Docker 컨테이너 내에서 코드를 실행하기 위한 안전한 샌드박스 환경입니다. 이 MCP 서버는 컨테이너화를 통해 보안을 유지하면서 AI 애플리케이션에 안전하고 격리된 코드 실행 환경을 제공합니다.
🌟 특징
- 유연한 컨테이너 관리 : 코드 실행을 위해 격리된 Docker 컨테이너를 생성하고 관리합니다.
- 사용자 정의 환경 지원 : 모든 Docker 이미지를 실행 환경으로 사용하세요
- 파일 작업 : 호스트와 컨테이너 간의 간편한 파일 및 디렉토리 전송
- 명령 실행 : 컨테이너화된 환경 내에서 모든 셸 명령을 실행합니다.
- 실시간 로깅 : 컨테이너 로그 및 명령 출력을 실시간으로 스트리밍합니다.
- 자동 업데이트 : 내장된 업데이트 확인 및 자동 바이너리 업데이트
- 다중 플랫폼 : Linux, macOS 및 Windows 지원
🚀 설치
필수 조건
빠른 설치
리눅스, 맥OS
지엑스피1
윈도우
설치 프로그램은 다음을 수행합니다.
- Docker 설치 확인
- 시스템에 적합한 바이너리를 다운로드하세요
- 필요한 구성 파일을 만듭니다
수동 설치
- 릴리스 페이지 에서 플랫폼에 맞는 최신 릴리스를 다운로드하세요.
- PATH에 있는 디렉토리에 바이너리를 넣으세요
- 실행 가능하게 만들기(Unix 계열 시스템에만 해당):Copy
🛠️ 사용 가능한 도구
sandbox_initialize
코드 실행을 위한 새로운 컴퓨팅 환경을 초기화합니다. 지정된 Docker 이미지를 기반으로 컨테이너를 생성합니다.
매개변수:
image(문자열, 선택 사항): 기본 환경으로 사용할 Docker 이미지- 기본값: 'python:3.12-slim-bookworm'
보고:
- 이 환경과 상호 작용하기 위해 다른 도구와 함께 사용할 수 있는
container_id
copy_project
샌드박스 파일 시스템에 디렉토리를 복사합니다.
매개변수:
container_id(문자열, 필수): 초기화 호출에서 반환된 컨테이너의 IDlocal_src_dir(문자열, 필수): 로컬 파일 시스템의 디렉토리 경로dest_dir(문자열, 선택 사항): 샌드박스 환경에서 src 디렉토리를 저장할 경로
write_file
샌드박스 파일 시스템에 파일을 씁니다.
매개변수:
container_id(문자열, 필수): 초기화 호출에서 반환된 컨테이너의 IDfile_name(문자열, 필수): 생성할 파일의 이름file_contents(문자열, 필수): 파일에 쓸 내용dest_dir(문자열, 선택 사항): 파일을 생성할 디렉토리(기본값: ${WORKDIR})
sandbox_exec
샌드박스 환경에서 명령을 실행합니다.
매개변수:
container_id(문자열, 필수): 초기화 호출에서 반환된 컨테이너의 IDcommands(배열, 필수): 샌드박스 환경에서 실행할 명령 목록- 예: ["apt-get update", "pip install numpy", "python script.py"]
copy_file
단일 파일을 샌드박스 파일 시스템에 복사합니다.
매개변수:
container_id(문자열, 필수): 초기화 호출에서 반환된 컨테이너의 IDlocal_src_file(문자열, 필수): 로컬 파일 시스템의 파일 경로dest_path(문자열, 선택 사항): 샌드박스 환경에서 파일을 저장할 경로
sandbox_stop
실행 중인 컨테이너 샌드박스를 중지하고 제거합니다.
매개변수:
container_id(문자열, 필수): 중지하고 제거할 컨테이너의 ID
설명: 지정된 컨테이너를 10초의 시간 초과로 정상적으로 중지하고 볼륨과 함께 제거합니다.
컨테이너 로그 리소스
컨테이너 로그에 대한 액세스를 제공하는 동적 리소스입니다.
리소스 경로: containers://{id}/logs
MIME 유형: text/plain
설명: 지정된 컨테이너의 모든 컨테이너 로그를 단일 텍스트 리소스로 반환합니다.
🔐 보안 기능
- Docker 컨테이너를 사용한 격리된 실행 환경
- Docker 컨테이너 제약을 통한 리소스 제한
- stdout 및 stderr 스트림 분리
🔧 구성
클로드 데스크탑
설치 프로그램이 자동으로 구성 파일을 생성합니다. 수동으로 구성해야 하는 경우:
리눅스
맥OS
윈도우
기타 AI 애플리케이션
MCP 서버를 지원하는 다른 AI 애플리케이션의 경우, code-sandbox-mcp 바이너리를 코드 실행 백엔드로 사용하도록 구성합니다.
🛠️ 개발
프로젝트를 로컬로 빌드하거나 개발에 기여하고 싶다면 DEVELOPMENT.md를 참조하세요.
📝 라이센스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
This server cannot be installed
Docker 컨테이너 내에서 코드를 실행하기 위한 안전한 코드 샌드박스 환경을 만드는 MCP 서버입니다.