mcp-server-docker의 개요
mcp-server-docker는 Christian Kreiling(GitHub 사용자 ckreiling)이 만들고 같은 이름으로 PyPI에 올린 서버로, 에이전트가 Python Docker SDK를 통해 Docker 엔진을 관리하게 합니다. 컨테이너, 이미지, 네트워크, 볼륨에 걸친 도구 19개, 컨테이너 로그와 실시간 통계용 리소스 템플릿 2개, 그리고 모델이 Terraform 방식으로 라벨이 붙은 컨테이너 묶음을 계획하고 적용하게 하는 docker_compose 프롬프트를 제공합니다. stdio로만 실행됩니다.
Docker SDK의 from_env 메서드로 연결하므로, 기본으로 /var/run/docker.sock의 로컬 소켓을 쓰고 DOCKER_HOST, DOCKER_TLS_VERIFY, DOCKER_CERT_PATH를 따릅니다. DOCKER_HOST를 ssh:// URL로 설정하면 SSH로 원격 엔진에 닿으며, 이 기능은 2025년 5월 v0.2.0에서 추가되었습니다. docker-compose.yml 파일을 수정하거나 읽지 않고, 실행 중인 컨테이너 안에서 exec하는 도구도 없습니다. 그런 도구를 추가하는 풀 리퀘스트는 2025년 7월부터 열려 있습니다.
저장소는 GPL-3.0 라이선스이며 GitHub 스타가 약 750개, 포크가 98개입니다. GitHub 릴리스는 2026년 8월 7일의 v0.3.0 하나로, MCP Python SDK 버전 2로 옮긴 릴리스입니다. 그 전의 마지막 PyPI 릴리스는 2025년 6월의 0.2.1이었습니다. 패키지는 10월 28일까지 한 달 동안 약 7,900회 다운로드되었습니다. 공식 MCP 레지스트리에는 올라 있지 않습니다.
Docker의 자체 MCP Toolkit인 docker/mcp-gateway와 혼동하면 안 됩니다. 그쪽은 에이전트가 사용자의 컨테이너를 관리하게 하는 것이 아니라, Docker 카탈로그의 MCP 서버를 컨테이너에서 실행합니다. 일 부 추천 목록에 아직 오르는 QuantGeekDev/docker-mcp는 2024년 12월 14일 이후 커밋이 없습니다.
mcp-server-docker 설치 방법
uvx mcp-server-dockermcp-server-docker, 쓸 만한 가치가 있습니까?
Docker 소켓에 접근하는 것은 호스트에 접근하는 것이며, 이 서버는 그 권한을 모델에게 고스란히 넘깁니다. Docker의 보안 가이드는 컨테이너가 호스트의 루트 디렉터리를 마운트해 제한 없이 바꿀 수 있으므로 신뢰할 수 있는 사용자만 데몬을 제어해야 한다고 말하고, 설치 문서는 docker 그룹이 root 수준의 권한을 준다고 말합니다. 서버의 README는 --privileged와 capability 플래그를 거부한다고 적고 있지만, create_container, run_container, recreate_container의 volumes 인수는 어떤 호스트 경로든 받습니다. 따라서 프롬프트 인젝션을 당한 에이전트는 /를 /host에 마운트하거나 Docker 소켓 자체를 안에 마운트한 컨테이너를 요청해, 두 플래그 없이도 같은 결과를 얻을 수 있습니다.
이를 좁힐 방법이 없습니다. 19개 도구 중 5개(list_containers, list_images, list_networks, list_volumes, fetch_container_logs)는 읽고, 나머지 14개는 씁니다. 컨테이너의 생성, 실행, 시작, 중지, 재생성, 이미지의 pull, push, 빌드, 삭제, 네트워크와 볼륨의 생성과 삭제입니다. 서버는 MCP 도구 어노테이션을 설정해 삭제와 재생성 도구 5개를 파괴적으로 표시하므로 클라이언트가 확인을 요청할 수 있지만, 읽기 전용 플래그, 허용 목록, 마운트 제한은 없습니다. /proc, /sys, /dev와 런타임 소켓의 마운트를 막는 2026년 3월의 풀 리퀘스트가 열려 있지만 병합되지 않았 습니다.
에이전트가 읽는 입력은 공격자가 통제하는 입력이기도 합니다. 컨테이너 로그, 이미지 라벨, 목록 도구가 돌려주는 상태 블록은 모두 모델로 돌아오므로, 공개 레지스트리에서 받은 컨테이너의 로그 한 줄이 그럴듯한 인젝션 경로가 됩니다. 2026년 4월에 올라온 공개 요청에 따르면 보고자는 3월에 호스트 파일 시스템 접근과 컨테이너 탈출의 세부 내용을 이메일로 보냈지만 답을 받지 못했고, 비공개 보안 연락처를 묻는 두 번째 요청이 10월 26일에 올라왔습니다. 공개된 GitHub 보안 권고는 없습니다.
유지보수는 멈춘 것이 아니라 느립니다. 2026년 8월 릴리스는 모든 도구에 테스트를 붙여 버전 2 Python SDK로 신중하게 다시 쓴 것이지만, 이전 릴리스로부터 14개월 뒤에 나왔습니다. 열린 issue와 풀 리퀘스트는 39개이고 그중 15개가 풀 리퀘스트이며, 제한 없는 로그 출력과, 한 사용자가 컨테이너 22개에 약 103 KB로 측정한 list_containers 결과에 대한 수정이 포함되어 있습니다. SSH에 쓰는 Paramiko는 4.0 미만으로 고정되어 있는데, 열린 issue에 따르면 이 때문에 알려진 보안 권고 하나가 패치되지 않은 채 남아 있습니다.
SSH 지원은 셸 도구로 Docker CLI를 실행하는 것과 이 서버를 구별하는 기능이며, 계획과 적용 프롬프트는 세심한 배려입니다. 어느 것도 핵심적인 득실을 바꾸지는 않습니다. 이 서버는 버려도 되는 VM이나 훔칠 만한 것이 없는 전용 Docker 호스트에 맞습니다. 에이전트를 공유 인프라에 접근시키려면 읽기 전용 모드와 허용 목록 모드가 있는 Kubernetes 서버가 더 잘 지켜진 방법입니다.
제 역할을 하는 곳
남는 Linux VM에서 자체 호스팅 앱을 시험해 보는 개발자
평범한 영어 설명으로 WordPress와 MySQL 컨테이너를 띄우기
프로젝트 이름과 함께 docker_compose 프롬프트를 호출하면, 모델이 계획을 제안하고 apply를 기다린 뒤, 나중에 묶음을 재개하거나 없앨 수 있도록 프로젝트 라벨을 붙여 run_container와 create_volume을 호출합니다. 무료이며, 다시 만들 수 있는 VM에서는 root 수준 노출의 대가가 작습니다.
임대한 Docker 호스트 하나에서 마케팅 사이트를 운영하는 1인 창업자
사이트 컨테이너가 계속 재시작되는 이유를 확인하고 채팅 창에서 재시작하기
DOCKER_HOST를 ssh://user@host로 설정하면 에이전트가 list_containers로 재시작 횟수를, fetch_container_logs로 마지막 로그 100줄을 읽을 수 있습니다. 같은 세션에서 볼륨을 삭제하거나 호스트 파일 시스템을 마운트할 수도 있으므로, 그 사이트 말고는 아무것도 없는 호스트에 두어야 합니다.
직원이 설치해도 되는 MCP 서버를 검토하는 직원 30명 규모 회사의 플랫폼 리드
개발자 노트북에서 Docker 서버를 허용할지 결정하기
답은 소켓에 달려 있습니다. Linux에서는 어떤 도구 호출이든 홈 디렉터리나 /를 마운트한 컨테이너를 만들 수 있고, 서버에는 이를 막을 스위치가 없습니다. 별도의 VM이나 rootless Docker 데몬으로 사용을 제한하는 정책이 모든 프롬프트를 감사하는 것보다 쌉니다.
도입 전 확인할 점
- 설정
- 클라이언트 설정에 uvx mcp-server-docker를 추가합니다(README는 Claude Desktop을 다룹니다). uv와 Python 3.12 이상이 필요합니다. Dockerfile이 제공되지만, 이미지는 직접 빌드하고 /var/run/docker.sock을 그 안에 마운트해야 합니다. 사용자 계정에서 docker ps가 작동하면, 몇 분 안에 첫 도구 호출이 됩니다.
- 연동
- 도구 19개입니다. 읽기 전용 5개(list_containers, list_images, list_networks, list_volumes, fetch_container_logs)와, run_container와 recreate_container부터 build_image, push_image, remove_volume까지 쓰기를 하는 14개입니다. 리소스 2개가 컨테이너 로그와 통계를 제공하고, 프롬프트 하나인 docker_compose가 라벨이 붙은 리소스에 대해 계획과 적용 루프를 돌립니다.
- 데이터와 개인정보
- Docker 데몬이 할 수 있는 일은 무엇이든 할 수 있으며, 표준 설치에서는 호스트의 root이고 SSH로는 원격 호스트에서 마찬가지입니다. 신뢰할 수 없는 이미지의 로그, 라벨, 컨테이너 상태가 모델에 닿습니다. 모든 것이 로컬에서 실행됩니다. 공개된 보안 권고는 없으며, 취약점을 비공개로 보고하겠다는 공개 요청 2건이 답을 받지 못했습니다.
- 대규모 사용 시 비용
- 무료이며, 비용은 컨텍스트입니다. list_containers는 inspect 수준의 전체 상태를 돌려주는데, 한 사용자는 컨테이너 22개에 약 103 KB로 측정했습니다. fetch_container_logs는 바이트 제한 없이 tail=all을 받습니다.
- 제한
- 실행 중인 컨테이너로의 exec, Docker Compose 파일 지원, 비밀 정보 처리가 없고(README는 민감한 데이터를 넘기지 말라고 합니다), --privileged나 capability 옵션도 없습니다. stdio 전용입니다. recreate_container는 이전 컨테이너의 설정을 이어받지 않습니다.
좋은 점
- 도구 19개가 컨테이너, 이미지, 네트워크, 볼륨을 다룹니다
- DOCKER_HOST를 설정하면 SSH로 원격 엔진을 씁니다
- 파괴적 도구에 클라이언트가 통제할 수 있는 MCP 어노테이션이 붙어 있습니다
- v0.3.0으로 다시 쓴 뒤 모든 도구에 테스트가 있습니다
아쉬운 점
- 읽기 전용 모드, 허용 목록, 마운트 제한이 없습니다
- /와 소켓을 포함해 어떤 호스트 경로든 마운트할 수 있습니다
- 보안 공개 요청이 2026년 4월부터 답을 받지 못했습니다
- 2026년 10월까지 16개월 동안 릴리스가 하나뿐입니다
추천 대상
기꺼이 다시 만들 수 있는 일회용 또는 전용 Docker 호스트에서 에이전트가 컨테이너를 실행하게 하고 싶은 개발자와 홈랩 사용자입니다.
mcp-server-docker 대안
mcp-server-docker: 자주 묻는 질문
- mcp-server-docker, 쓸 만한 가치가 있습니까?
- 버려도 되는 컴퓨터에 쓰기에는 깔끔한 Docker 서버입니다. 하지만 읽기 전용 모드 없이 에이전트에게 호스트에 대한 root에 준하는 통제권을 주며, 유지보수자는 두 건의 보안 보고에 답하지 않았습니다. 평점은 5점 만점에 3.3점입니다.
- mcp-server-docker의 가격은 얼마입니까?
- 무료 오픈소스(GPL-3.0)입니다. 비용은 Docker를 실행하는 호스트에 대해서만 냅니다.
- mcp-server-docker의 단점은 무엇입니까?
- 읽기 전용 모드, 허용 목록, 마운트 제한이 없습니다; /와 소켓을 포함해 어떤 호스트 경로든 마운트할 수 있습니다; 보안 공개 요청이 2026년 4월부터 답을 받지 못했습니다; 2026년 10월까지 16개월 동안 릴리스가 하나뿐입니다.
- mcp-server-docker에 적합한 사람은 누구입니까?
- 기꺼이 다시 만들 수 있는 일회용 또는 전용 Docker 호스트에서 에이전트가 컨테이너를 실행하게 하고 싶은 개발자와 홈랩 사용자입니다.
- 팀이나 프로덕 션 환경에서 mcp-server-docker의 비용은 얼마입니까?
- 무료이며, 비용은 컨텍스트입니다. list_containers는 inspect 수준의 전체 상태를 돌려주는데, 한 사용자는 컨테이너 22개에 약 103 KB로 측정했습니다. fetch_container_logs는 바이트 제한 없이 tail=all을 받습니다.
- mcp-server-docker에 회사 데이터를 맡겨도 안전합니까?
- Docker 데몬이 할 수 있는 일은 무엇이든 할 수 있으며, 표준 설치에서는 호스트의 root이고 SSH로는 원격 호스트에서 마찬가지입니다. 신뢰할 수 없는 이미지의 로그, 라벨, 컨테이너 상태가 모델에 닿습니다. 모든 것이 로컬에서 실행됩니다. 공개된 보안 권고는 없으며, 취약점을 비공개로 보고하겠다는 공개 요청 2건이 답을 받지 못했습니다.
- mcp-server-docker의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 MCP Server Kubernetes, Filesystem (reference server) 및 Terraform MCP Server입니다.
답변 확인일: 2026년 10월 28일.