opencode-sandbox

사전 빌드된 공개 GHCR 이미지에서 격리된 opencode 인스턴스를 생성하여 Claude Code에 MCP 서버로 전달합니다. 빌드 단계가 없고 opencode 포크를 체크아웃할 필요도 없습니다. 각 인스턴스는 고유한 명명된 볼륨을 가진 독자적인 Docker Compose 프로젝트이며, 작업 공간은 호스트 바인드가 아닌 명명된 볼륨이므로 사용자의 파일 시스템을 볼 수 없습니다. 이미지는 공개되어 익명으로 가져올 수 있습니다. 백엔드는 opencode 1.18.4를 보고하며 MCP 브리지는 80개의 도구를 노출합니다.

설치

소스에서 빌드하여 PATH에 바이너리를 배치하세요:

bun run build
cp dist/opencode-sandbox ~/.local/bin/

(bun run install-local은 두 작업을 한 번에 수행합니다.) 또는 이 저장소의 GitHub Releases에서 사전 빌드된 바이너리를 받으세요.

Related MCP server: devcontainer-mcp

빠른 시작

인스턴스를 생성하세요. 셸에 이미 있는 모든 공급자 API 키(ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY, OPENROUTER_API_KEY)는 생성 시 해당 인스턴스로 전달됩니다. UI 로그인 단계나 관리할 auth.json이 없습니다.

opencode-sandbox create scratch --seed ./my-project --config ./opencode.jsonc

--seed는 인스턴스가 처음 시작되기 전에 디렉터리를 새 작업 공간에 복사합니다. --config는 해당 인스턴스에만 적용되는 opencode.jsonc를 배치합니다. 둘 다 선택 사항입니다.

Claude Code에 등록하세요. create는 이 줄을 출력하며, url은 나중에 다시 출력합니다:

opencode-sandbox url scratch
claude mcp add --transport http scratch http://127.0.0.1:4784/mcp

이제 사용하세요. 해당 인스턴스의 80개 도구(읽기, 쓰기, 셸 명령 실행, 모두 자체 /workspace로 범위가 제한됨)가 해당 Claude Code 세션에서 사용 가능합니다. 작업이 끝나면:

opencode-sandbox destroy scratch --yes

destroy는 작업 공간을 포함하여 컨테이너와 해당 볼륨을 제거합니다.

웹 UI도 사용할 수 있으며, 생성 시 --web 옵션으로 활성화할 수 있습니다. 이 옵션이 없으면 MCP 브리지가 유일한 인터페이스입니다.

보안 참고

MCP 브리지에는 자체적인 인바운드 인증이 없습니다. 해당 포트에 도달할 수 있는 사람은 누구나 인스턴스의 /workspace 내에서 파일을 읽고 쓰고 셸 명령을 실행하는 전체 opencode 도구 표면을 사용할 수 있습니다. 공개된 포트는 기본적으로 127.0.0.1에 바인딩됩니다. 그 상태로 유지하세요. 실제 인증 레이어를 앞에 두지 않고 0.0.0.0으로 확장하거나 공개 리버스 프록시 뒤에 두지 마세요.