Sandbox MCP

샌드박스 MCP 는 LLM(MCP 호스트/클라이언트)이 안전하고 격리된 Docker 컨테이너에서 코드를 실행할 수 있도록 하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

LLM은 코드 생성에는 매우 뛰어나지만, 대부분은 자신이 생성한 코드를 실행할 수 없습니다 . 결국 테스트되지 않은 코드를 자신의 컴퓨터에서 직접 실행하게 되어 예상치 못한 심각한 결과를 초래할 수 있습니다.

LLM에게 코드를 안전하게 테스트할 수 있는 도구를 제공하면 이러한 문제를 방지하고 더 적은 반복으로 더 정확한 코드를 생성하는 데 도움이 됩니다.

샌드박스 MCP는 누구나 로컬에서 실행되는 간단한 AI 기반 MCP 서버를 통해 만들고 구성할 수 있는 사용하기 쉬운 실행 환경을 LLM에 제공합니다.

Codapi 에서 영감을 얻었습니다. 일부 샌드박스는 Codapi 샌드박스 와 동일합니다.

사용 사례

샌드박스 MCP는 다음을 포함하되 이에 국한되지 않는 다양한 작업에 사용할 수 있습니다.

• 안전한 코드 실행 : LLM에서 생성된 모든 코드를 안전하고 격리된 환경에서 실행하여 신뢰할 수 없거나 잠재적으로 유해한 코드로부터 시스템을 보호합니다.
• 코드 테스트 : 대규모 프로젝트나 프로덕션 시스템에 통합하기 전에 다양한 언어 및/또는 다양한 환경의 구성으로 코드를 자동으로 테스트하고 검증합니다.
• 사용자 코드 검증 : 사용자가 제출한 코드나 스크립트를 안전하게 실행하고 검사하여 예상대로 동작하고 악의적인 동작을 수행하지 않는지 확인합니다.
• 네트워크 문제 해결 : 시스템을 노출시키지 않고 격리된 네트워크 도구를 사용하여 연결 문제를 진단하고, 엔드포인트를 테스트하고, 네트워크 성능을 분석합니다.
• 교육 및 인터뷰 코딩 : 학습, 교육 또는 기술 인터뷰를 위해 코드 조각을 즉시 컴파일하고 실행하여 안전하고 일시적인 환경에서 즉각적인 피드백을 제공합니다.
• 자동화된 코드 검토 및 피드백 : LLM이 코드를 자동으로 실행, 테스트, 검토할 수 있도록 하여 코드가 병합되거나 배포되기 전에 실행 가능한 피드백이나 제안을 제공합니다.

데모

이 데모에서는 Sandbox MCP가 Claude Desktop과 함께 작동하는 방식을 보여줍니다.

GIF가 선명하지 않으면 비디오 를 시청해 보세요.

설치

바이너리 다운로드

운영 체제(예: Darwin )와 프로세서 아키텍처( arm64 )에 적합한 바이너리를 릴리스 페이지 ( sandbox-mcp_Darwin_arm64.tar.gz )에서 다운로드할 수 있습니다.

Go를 통해 설치

필수 조건:

• 1.24 이상으로 가세요

지엑스피1

sandbox-mcp 바이너리 경로를 가져옵니다.

소스에서 빌드

개발 섹션을 참조하세요.

용법

초기화

LLM과 함께 sandbox-mcp 사용하기 전에 구성을 초기화해야 합니다.

[!NOTE] Docker가 설치되어 실행 중인지 확인하세요.

MCP 호스트/클라이언트 사용

Claude Desktop의 경우 claude_desktop_config.json 에, Cursor IDE의 경우 mcp.json 에 다음을 추가하세요.

[!NOTE] path/to/sandbox-mcp sandbox-mcp 바이너리의 실제 경로로 바꿔야 합니다.

사용 가능한 샌드박스

[!중요한]

나만의 샌드박스

$XDG_CONFIG_HOME/sandbox-mcp/sandboxes 에서 나만의 샌드박스를 만들고 추가할 수 있습니다. 샌드박스는 기본적으로 Dockerfile과 JSON 구성으로 구성됩니다. 자세한 내용은 예제와 가이드를 참조하세요.

개발

저장소를 포크하고 복제합니다.

디렉토리로 변경하세요:

종속성 설치:

프로젝트를 빌드하세요:

로컬 빌드를 가리키도록 MCP 서버 구성을 업데이트하세요.

특허

MIT 라이센스