Docker Build MCP TypeScript Server
이 프로젝트는 MCP(modelcontextprotocol) 표준을 완벽히 따르는 Docker Build MCP 서버입니다.
주요 특징
- MCP 표준 완벽 지원: Cursor, Claude 등 MCP 클라이언트에서 tool discovery/실행 100% 호환
- 도커 이미지 관리 자동화: build, run, stop, rm, rmi, push 등 도커 CLI의 주요 기능을 API로 제공
- SSE(Server-Sent Events) 및 stdio 모드 지원
- 확장성 높은 구조: 각 도커 명령이 독립적인 tool로 구현되어 유지보수 및 확장 용이
- 실행 명령어 및 결과 로그: 모든 도커 명령 실행 시 콘솔에 명령어와 결과가 출력됨
디렉토리 구조
./
├── dist/ # 빌드 결과물
├── node_modules/ # 의존성 모듈
├── src/
│ ├── config/ # 서버 및 도구 설정
│ ├── models/ # 타입/스키마 정의
│ ├── prompts/ # MCP 프롬프트 핸들러
│ ├── resources/ # 리소스 핸들러
│ ├── tools/ # 도커 관련 MCP 도구 (build, run, stop, rm, rmi 등)
│ ├── utils/ # 유틸리티 함수
│ ├── http-server.ts # HTTP 서버 진입점
│ └── index.ts # MCP 서버 진입점
├── tests/ # 테스트 코드
├── package.json # 프로젝트 메타/스크립트
├── tsconfig.json # 타입스크립트 설정
└── vitest.config.ts # 테스트 설정
주요 기능 및 지원 도구
- docker_build: 여러 파일을 context로 받아 Docker 이미지를 빌드
- docker_run: 원하는 옵션으로 컨테이너 생성 및 실행
- docker_ps: 실행 중/전체 컨테이너 목록 조회 (all 옵션 지원)
- docker_stop, docker_stop_multi: 컨테이너(들) 중지
- docker_rm, docker_rm_multi: 컨테이너(들) 삭제 (삭제 전 자동 중지)
- docker_images: 로컬 이미지 목록 조회
- docker_rmi, docker_rmi_multi: 이미지(들) 삭제
- docker_push: 태그된 이미지를 레지스트리로 푸시
- docker_login: 도커 레지스트리 로그인
- docker-inspect: 컨테이너/이미지 상세 정보 조회
- docker-container-prune, docker-image-prune, docker-network-prune, docker-volume-prune: 불필요한 리소스 일괄 정리
설치 및 실행 방법
- 의존성 설치
npm install
- 개발 서버 실행 (SSE 모드)
ENABLE_UNSAFE_SSE_TRANSPORT=1 npm run dev
- 빌드 및 배포 실행
npm run build
npm start
예시: MCP 툴 사용
- MCP 클라이언트에서 tool discovery를 통해 위 도구들을 자동 인식/실행 가능
- 각 도구는 child_process로 docker CLI를 직접 호출하여 실제 도커 환경과 동일하게 동작
테스트
tests/디렉토리 내에 각 도구별 테스트 코드 포함- vitest 기반 테스트 지원
기여 및 문의
- 이 프로젝트는 확장/기여를 환영합니다.
- MCP 표준, 도커 자동화, 추가 기능 문의는 언제든 이슈/PR로 남겨주세요.
실제 build/push/run 등은 child_process로 docker CLI를 호출합니다.
🐳 DinD(Docker-in-Docker) 완전 분리형 MCP 서버 실전 배포 가이드
1. 최신 이미지 빌드 및 도커허브 푸시
docker build -t ekdh600/build-mcp:latest .
docker push ekdh600/build-mcp:latest
2. 최신 코드 git 커밋/푸시
cd docker-build-mcp-ts
git add .
git commit -m "docs: DinD 구조 및 쿠버네티스 대응 최신화"
git push
3. DinD 기반 완전 분리형 컨테이너 구동(쿠버네티스 대응)
- 호스트 도커 소켓 마운트 없이, 내부 dockerd만 사용
- 쿠버네티스 환경에서도 동일하게 동작
docker run --privileged --name build-mcp -d -p 3000:3000 ekdh600/build-mcp:latest
- 내부 dockerd가 자동으로 기동되고 MCP 서버가 0.0.0.0:3000에서 listen
- MCP 툴(docker_ps, docker_run 등)은 컨테이너 내부 도커 환경만 제어(호스트와 완전 분리)
- 커서/클라우드/쿠버네티스 환경에서도 동일하게 MCP 서버로 등록하여 사용 가능
4. MCP 툴 실전 사용 예시(커서/클라우드)
- MCP 서버 주소:
http://<호스트IP>:3000 - 커서에서 MCP 서버 등록 후 docker_ps, docker_run 등 사용
- 생성/조회되는 컨테이너는 모두 DinD 내부 환경에만 존재