샌드박스 MCP

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

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

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

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

데모

아래 데모는 MCP가 Claude Desktop과 어떻게 작동하는지 보여줍니다. 아래 GIF가 잘 보이지 않으면 동영상을 시청하세요.

설치

바이너리 다운로드

"릴리스" 페이지에서 운영 체제와 프로세서 아키텍처에 적합한 바이너리를 다운로드 하여 사용할 수 있습니다.

Go를 통해 설치

필수 조건:

1.24 이상으로 가세요

지엑스피1

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

which sandbox-mcp

소스에서 빌드

아래의 개발 섹션을 참조하세요.

용법

초기화

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

# Create the configuration directory and
# pull the default sandboxes from GitHub
sandbox-mcp --pull

# Build the Docker images for the sandboxes
sandbox-mcp --build

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

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

Claude Desktop의 경우 claude_desktop_config.json 에, Cursor의 경우 mcp.json 다음을 추가합니다.

{
    "mcpServers": {
        "sandbox-mcp": {
            "command": "path/to/sandbox-mcp",
            "args": [
                "--stdio"
            ]
        }
    }
}

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

사용 가능한 샌드박스

껍데기

엄격한 보안 및 네트워크 제약이 있는 Linux 환경에서 셸 명령을 실행합니다.

파이썬

미리 설치된 라이브러리 세트를 사용하여 Python 코드를 실행합니다.

[!중요한]
나만의 샌드박스
sandboxes 디렉터리에 샌드박스 이름으로 새 디렉터리를 만들고 Dockerfile 과 config.json 파일을 추가하여 나만의 샌드박스를 만들 수 있습니다. 예시는 /sandboxes/를 참조하세요.

네트워크 도구

격리된 Linux 샌드박스에서 다양한 네트워크 도구를 사용하세요. 컨테이너는 네트워크 접근 권한을 가지고 있습니다.

사용 가능한 도구 목록은 jonlabelle/docker-network-tools를 참조하세요.

가다

격리된 샌드박스에서 간단한 Go 코드를 실행합니다.

자바스크립트

Node.js를 사용하여 JavaScript 코드를 실행합니다.

개발

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

git clone https://github.com/username/sandbox-mcp.git

디렉토리로 변경하세요:

cd sandbox-mcp

종속성 설치:

make deps

프로젝트를 빌드하세요:

make build

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

{
    "mcpServers": {
        "sandbox-mcp": {
            "command": "/path/to/sandbox-mcp/dist/sandbox-mcp",
            "args": [
                "--stdio"
            ]
        }
    }
}

특허

MIT 라이센스

Sandbox MCP

Integrations