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 내부 환경에만 존재

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Related MCP Servers

docker-mcp
QuantGeekDev
A
security
A
license
A
quality
A powerful Model Context Protocol (MCP) server for Docker operations, enabling seamless container and compose stack management through Claude AI.
Last updated -
4
424
MIT License
MCP Server Template
stevennevins
A
security
F
license
A
quality
A template for creating Model Context Protocol (MCP) servers in TypeScript, offering features like container-based dependency injection, a service-based architecture, and integration with the LLM CLI for architectural design feedback through natural language.
Last updated -
1
3
7
MCPKit
ribeirogab
A
security
A
license
A
quality
A simple TypeScript library for creating Model Context Protocol (MCP) servers with features like type safety, parameter validation, and a minimal code API.
Last updated -
1
4
1
MIT License
MCP TypeScript Server Template
Mearman
-
security
F
license
-
quality
A template repository for building Model Context Protocol (MCP) servers with TypeScript, featuring full TypeScript support, testing setup, CI/CD pipelines, and modular architecture for easy extension.
Last updated -
1

View all related MCP servers

Docker Build MCP Server