MCP

일회용 Docker 컨테이너에서 JavaScript 한 조각을 실행한다

격리 컨테이너에서 JavaScript 를 돌리거나 npm 의존성을 임시로 설치하려는 사람에게 맞다. 다만 로컬에 Docker 가 먼저 설치되어 실행 중이어야 하고, 첫 시도는 일회용 컨테이너로 가며 Detached Mode 는 켜지 않는다.

Official source · node-code-sandbox-mcp

Install

"command": "npx",
      "args": ["-y", "node-code-sandbox-mcp"],

누구에게 맞나

이미 로컬에서 Docker 를 돌릴 수 있고, MCP 로 임의의 JavaScript 를 임시 컨테이너에 넣어 실행한 뒤 필요하면 그 자리에서 npm 의존성을 설치하고 싶다면 이 서버가 맞다. 공식 설명은 Model Context Protocol 을 구현한 Node.js 서비스이며, 짧은 수명의 Docker 컨테이너에서 임의의 JavaScript 를 실행하고 npm 의존성의 즉시 설치를 지원한다고 한다.

Docker 가 설치되지 않았거나 실행 중이 아닌 기기에는 맞지 않는다. 현재 발췌는 「일회성 스크립트」와 「Detached Mode 로 스크립트가 끝난 뒤에도 컨테이너를 살려 둔다」 두 종류의 능력만 기술하고, 도구 함수 이름, 매개변수 표, 자원 한도는 주지 않는다. 그대로 복사할 호출 시그니처가 필요하다면 증거는 여기서 멈춘다.

첫 사용은 컨테이너를 계속 살려 두지 말고, 쓰고 버리는 일회용 컨테이너를 선택해야 한다. 임의의 스크립트 실행은 쓰기 방향 동작이다. 컨테이너를 새로 만들고, 당신이 준 코드를 돌리며, 의존성을 가져올 수 있다.

3분 만에 첫 시도

먼저 Docker 가 설치되어 있고 실행 중인지 확인한다. 공식 권장 주 경로는 다른 설치기를 병렬로 쓰지 말고, MCP 클라이언트의 서버 설정에 아래 블록을 넣는 것이다:

      "command": "npx",
      "args": ["-y", "node-code-sandbox-mcp"],

이 블록을 지금 쓰는 MCP 클라이언트 설정 위치에 넣는다. 발췌는 설정 파일 이름을 고정하지 않았으므로 특정 클라이언트 경로를 확인된 것으로 쓰지 마라. 저장하고 해당 서버를 다시 로드한다.

착수 전에 두 가지를 대조한다. Docker 데몬이 실제로 돌고 있는지. 제출하려는 스크립트가 직접 실행할 내용인지. 부작용은 이렇다. 서비스가 일회용 Docker 컨테이너를 새로 만들고, 그 안에서 이 JavaScript 를 실행하며, 그 자리에서 npm 의존성을 설치할 수 있다. 이 두 가지를 확인한 뒤 「완전히 새로운 일회용 컨테이너에서 일회성 JS 스크립트를 돌린다」는 요청을 보낸다. 첫 시도에는 Detached Mode 를 켜지 마라.

성공 신호는 이번 요청이 일회용 컨테이너 경로로 돌아가는 것이며, Docker 가 실행 중이 아니거나 npx 가 node-code-sandbox-mcp 를 띄우지 못한다는 메시지가 아니다. 이것은 제로 위험 읽기가 아니다. 컨테이너, 스크립트 실행, 의존성 설치가 일어나며, 네트워크 없음이나 프라이버시 경계 없음과도 같지 않다.

사용 사례

사례 1: 쓰고 버리는 스크립트를 돌린다. 발췌는 완전히 새로운 일회용 컨테이너에서 일회성 JS 스크립트를 실행할 수 있다고 명시한다. 스크립트 내용을 먼저 확인한 뒤 제출한다. 대조할 수 있는 결과는 이 스크립트가 새 컨테이너에서 실행되었다는 점까지다. 반환 필드, 표준 출력 형식, 도구 이름은 현재 발췌에 없으므로 구체 필드를 확인된 것으로 쓰지 마라.

사례 2: 스크립트가 끝난 뒤에도 컨테이너를 살려 두어야 하는 경우, 예를 들어 오래 실행되는 서비스. 발췌는 Detached Mode 가 스크립트 실행 후 컨테이너를 살려 둘 수 있다고 명시한다. 일회용 경로보다 부작용이 크다. 컨테이너가 남는다. 발췌에는 중지, 삭제, 철회 단계가 없으므로 「컨테이너를 끈다」를 공식 복구 경로로 쓰지 마라. 컨테이너를 계속 살려 둘 필요가 분명할 때만 이 경로를 탄다.

이 두 사례는 「일회성 실행」과 「실행 후 유지」에 각각 대응한다. 확인되지 않은 한 번의 호출로 섞지 마라.

사용 경계

사용 전제는 Docker 가 이미 설치되어 실행 중이어야 한다는 것이다. 주 설치 경로는 npx -y node-code-sandbox-mcp 이다. 능력상 대조할 수 있는 것은 완전히 새로운 일회용 컨테이너에서 JS 한 조각을 돌리는 것, 그리고 Detached Mode 가 스크립트 종료 후 컨테이너를 살려 두는 것이다. npm 의존성 즉시 설치도 전체 설명에 쓰여 있지만 설치 범위, 캐시 위치, 네트워크 정책은 현재 발췌에 없다.

공식 페이지는 https://github.com/alfonsograziano/node-code-sandbox-mcp . 발췌에는 자격 증명 필드, 클라이언트 목록, CPU 나 메모리 숫자, 철회나 정리 명령이 없다. 컨테이너 실행을 마음대로 롤백할 수 있다고 이해하지 말고, 나오지 않은 도구 이름과 매개변수를 보완하지 마라.