Docker MCP Gateway의 개요
Docker MCP Gateway는 CLI 플러그인 docker mcp와 Docker Desktop의 MCP Toolkit을 구동하는 오픈소스 코드입니다. 컨테이너를 관리하는 MCP 서버가 아닙니다. Claude Desktop, Claude Code, Cursor, VS Code 같은 MCP 클라이언트와 여러 MCP 서버 사이에 놓이는 프록시로, 어떤 서버의 도구가 호출되면 그 서버를 전용 Docker 컨테이너에서 시작하고, 해당 서버의 시크릿이나 OAuth 토큰을 주입하며, 모두를 stdio, SSE 또는 Streamable HTTP의 단일 엔드포인트로 노출합니다. 서버는 Docker의 MCP Catalog(Docker 문서에 따르면 300+ 서버), 임의의 OCI 이미지, 공식 MCP 레지스트리, 로컬 YAML 파일에서 가져오며, 프로필로 묶어 레지스트리에 push하고 공유할 수 있습니다.
따라서 mcp-server-docker(이 사이트에서는 docker로 리뷰)와는 다른 것입니다. 그쪽은 에이전트에게 Docker 데몬에서 컨테이너를 생성, 실행, 삭제하는 도구를 주는 커뮤니티 서버입니다. 게이트웨이는 데몬을 이용해 도구 서버를 격리된 상태로 실행할 뿐, 모델에게 범용 컨테이너 관리 도구를 직접 주지 않습니다.
저장소는 MIT 라이선스이고 Go로 작성되었으며 GitHub 스타 약 1,630개, 포크 293개입니다. 릴리스가 잦습니다. 2026년 10월 21일 v0.44.2에 이어 10월 26일 v0.44.3이 나왔습니다. Docker Desktop에 포함되어 있고, Docker 문서는 Desktop 없이 Docker Engine에 수동으로 설치하는 방법도 설명합니다.
Docker MCP Gateway 설치 방법
docker mcp gateway run (bundled with Docker Desktop; on Docker Engine, install the docker-mcp binary from GitHub releases into ~/.docker/cli-plugins)Docker MCP Gateway, 쓸 만한 가치가 있습니까?
가장 큰 가치는 격리입니다. 각 서버는 기본적으로 전용 컨테이너에서 1 CPU와 2 GB 메모리, no-new-privileges로 실행되고, 호스트의 환경 변수를 받지 않으며, 마운트를 허용하지 않는 한 호스트 파일 시스템에도 접근하지 못합니다. 마운트는 기본이 읽기 전용이고 허용 목록에 있는 경로 아래여야 합니다. 시크릿은 그것을 선언한 서버에만 전달되며, 기본으로 켜져 있는 --block-secrets가 도구의 인수와 응답에서 시크릿처럼 보이는 값을 검사합니다. Docker는 카탈로그의 로컬 서버를 직접 빌드하고 서명하며 각각의 SBOM을 공개합니다. mcp/ 네임스페이스의 이미지는 서명 검증이 기본으로 켜져 있습니다. 호출 로그도 기본으로 켜져 있으며, 도구 이름과 인수의 형태만 기록하고 값은 기록하지 않습니다.
이런 기본값이 처음부터 있었던 것은 아닙니다. 저장소는 지금까지 10건의 보안 권고를 공개했습니다. 2026년 7월에만 컨테이너 모드에서 프록시된 도구에 인증 없이 접근할 수 있는 문제와 동적 도구를 통한 검증되지 않은 바인드 마운트라는 critical 2건을 공개했고, 서명 검증이 기본으로 꺼져 있었다는 high 등급 문제도 있었습니다. 모두 0.43.1에서 수정되었습니다. HTTP 전송의 DNS 리바인딩 결함은 2025년 12월 v0.28.0에서, 가장 최근의 2건(모두 medium)은 0.44.1에서 고쳐졌습니다. 이 기록은 감사를 받고 빠르게 대응하는 프로젝트임을 보여 주는 동시에, 오래된 버전에 고정하는 것이 실제 위험이라는 뜻이기도 합니다.
설계상 남는 노출도 있습니다. 서버가 제한을 선언하거나 --block-network로 실행하지 않는 한 외부로 나가는 네트워크는 열려 있고, 보안 문서는 게이트웨이의 경계를 넘지 않는 한 프롬프트 인젝션과 오염된 도구 설명을 범위 밖으로 둡니다. Toolkit에서 기본으로 켜지는 Dynamic MCP는 에이전트에게 mcp-find와 mcp-add를 주어 세션 도중 카탈로그에서 서버를 추가하게 합니다. 설정 수고는 덜지만 모델이 스스로 도구 목록을 넓힐 수 있게 되며, docker mcp feature disable dynamic-tools로 끌 수 있습니다. 도구를 연결하는 JavaScript를 작성하는 코드 모드는 Docker 스스로 아직 신뢰할 수 없다고 밝힙니다.
게이트웨이는 Docker Desktop 없이도 동작하지만 부차적인 경로입니다. Docker Engine에서는 바이너리를 직접 ~/.docker/cli-plugins에 내려받고, Desktop이 실행 중이 아니라는 오류가 나면 DOCKER_MCP_IN_CONTAINER=1을 설정하고, 프로필을 수동으로 켜고, 시크릿을 Desktop 저장소 대신 .env 파일에 두고, OAuth가 동작하기 전에 DOCKER_MCP_USE_CE=true와 credential helper를 갖춰야 합니다. 모든 서버는 컨테이너 이미지여야 하며, 일반 npx나 uvx 서버를 실행하게 해 달라는 요청은 2025년 9월부터 열려 있고 122건의 열린 이슈 중 하나입니다. Desktop을 쓰는 경우 직원 250명 이상 또는 매출 1,000만 달러 이상인 기업은 유료 좌석이 필요하며, 월 9달러부터입니다.
대안과 비교하면 직접 운영과 호스팅형 사이에 놓입니다. Stacklok의 ToolHive는 서버마다 컨테이너를 두는 비슷한 방식에 팀 정책을 더 강조합 니다. Composio와 Pipedream은 도구와 OAuth를 대신 호스팅하지만, 그만큼 그들의 서버가 데이터를 보게 됩니다. Docker의 게이트웨이는 모든 것을 내 컴퓨터에 두며, 이미 Docker를 쓰는 개발자에게는 낯선 사람이 만든 서버를 설치하는 위험의 대부분을 덜어 줍니다.
제 역할을 하는 곳
같은 노트북에서 Claude Code와 Cursor를 쓰는 개발자
GitHub, Notion, Postgres 서버를 두 번 설정하고 API 키를 평문 JSON에 두는 일을 그만두기
docker mcp profile create로 프로필을 만들고 카탈로그 서버 3개를 추가한 뒤, 키를 docker mcp secret으로 저장하고 클라이언트마다 docker mcp client connect를 실행합니다. 두 편집기가 같은 게이트웨이를 호출하게 되고, 키는 어느 클라이언트 설정 파일에도 남지 않습니다.
직원 40명 규모 소프트웨어 회사의 보안 책임자
직원들이 MCP 서버를 쓰되 임의의 npm 패키지를 자기 컴퓨터에 설치하지 않게 하기
docker mcp catalog create로 승인된 서버만 담은 자체 카탈로그를 만들어 회사 레지스트리에 push합니다. 직원들이 이를 pull하고, 프로필마다 도구 허용 목록으로 에이전트가 호출할 수 있는 범위를 줄입니다. 이 규모에서 Desktop 좌석은 매출이 1,000만 달러 미만일 때만 무료입니다.
Linux VM에서 사내 에이전트 서비스를 구축하는 플랫폼 엔지니어
Docker Desktop 없이 정해진 MCP 도구 묶음을 HTTP로 에이전트에 제공하기
docker/mcp-gateway 이미지를 Docker Compose로 실행하고 Docker 소켓을 마운트한 뒤, --servers로 허용할 서버를, --transport streaming과 MCP_GATEWAY_AUTH_TOKEN의 토큰을 지정합니다. Desktop 라이선스는 적용되지 않고, 시크릿은 .env 파일에서 읽으며 --block-network로 외부 통신을 좁힙니다.
도입 전 확인할 점
- 설정
- Docker Desktop(README는 4.59 이상을 요구합니다)에서 MCP Toolkit을 켜고 카탈로그에서 서버를 추가한 뒤 클라이언트를 연결합니다. 클라이언트 설정은 docker mcp gateway run 하나뿐입니다. Docker Engine에서는 GitHub 릴리스에서 docker-mcp를 ~/.docker/cli-plugins에 내려받거나, /var/run/docker.sock을 마운트해 docker/mcp-gateway 이미지를 실행합니다. 문서는 Claude Desktop, Claude Code, Cursor, VS Code를 다룹니다.
- 연동
- 게이트웨이 자체 도구는 관리용으로 mcp-find, mcp-add, mcp-config-set, mcp-remove, mcp-exec와 실험적인 code-mode입니다. 나머지는 켜 둔 서버에서 오며, Docker 카탈로그의 300+ 서버, 임의의 OCI 이미지, MCP 레지스트리가 대상입니다. --tools와 프로필별 허용 목록으로 개별 도구를 고릅니다. 인터셉터로 호출 전후에 직접 만든 스크립트를 실행할 수 있습니다.
- 데이터와 개인정보
- 로컬에서 실행됩니다. 게이트웨이는 켜 둔 서버와 그 시크릿이 닿는 곳까지 닿으며, 게이트웨이 자체도 Docker 소켓이 필요한데 이는 표준 Linux 설치에서 root와 같은 권한입니다. Desktop에서는 게이트웨이 지표가 Docker의 사용 분석으로 전송되며 Desktop 설정에서 끌 수 있습니다. Desktop이 없으면 텔레메트리 문서는 아무것도 내보내지 않는다고 설명합니다. 원격 서비스의 도구 출력은 시크릿 검사를 빼면 걸러지지 않고 모델에 전달됩니다.
- 대규모 사용 시 비용
- 소프트웨어는 무료입니다. Desktop 라이선스는 직원 250명 또는 매출 1,000만 달러부터 필요하며, 연간 결제 기준 사용자당 월 Pro 9달러, Team 15달러, Business 24달러입니다. 실행 중인 서버는 기본적으로 각각 최대 1 CPU와 2 GB를 확보하므로, --long-lived로 10개를 상주시키면 노트북 자원을 상당히 차지할 수 있습니다.
- 제한
- 열린 이슈 122건, 열린 풀 리퀘스트 52건입니다. 컨테이너 없는 npx와 uvx 서버, 환경 변수로 시크릿 전달, 기본 카탈로그 끄기, Engine 모드의 OAuth 등이 요청으로 남아 있습니다. 동적 도구로 추가한 서버는 그 세션에서만 유지됩니다. 코드 모드는 실험 단계입니다.
좋은 점
- 각 서버를 CPU, 메모리, 마운트 제한이 있는 컨테이너로 격리
- 시크릿 차단, 서명 검증, HTTP Bearer 토큰이 기본으로 켜짐
- Claude, Cursor, VS Code가 하나의 엔드포인트와 프로필을 공유
- 활발한 릴리스와 공개된 보안 모델, 빠른 수정
아쉬운 점
- 지금까지 보안 권고 10건, 2026년 7월에 critical 2건
- Docker Engine에서 쓰려면 수동 설치와 우회가 필요
- 외부 네트워크 접근이 기본으로 열려 있음
- 모든 서버가 컨테이너 이미지여야 하며 일반 npx나 uvx는 불가
추천 대상
이미 Docker를 쓰면서 여러 MCP 서버를 자기 컴퓨터의 격리되고 기록이 남는 단일 엔드포인트 뒤에 두고 싶은 개발자와 소규모 팀에 맞습니다.
Docker MCP Gateway 대안
Docker MCP Gateway: 자주 묻는 질문
- Docker MCP Gateway, 쓸 만한 가치가 있습니까?
- 최신 릴리스를 유지하고 Docker Desktop 중심으로 만들어졌다는 점을 받아들인다면, 로컬 MCP 서버 십여 개를 각각에 노트북을 통째로 맡기지 않고 돌리기 위한 믿을 만한 기본 선택지입니다. 평점은 5점 만점에 4.0점입니다.
- Docker MCP Gateway의 가격은 얼마입니까?
- 게이트웨이는 무료 오픈소스(MIT)입니다. 이를 MCP Toolkit으로 포함하는 Docker Desktop은 개인 사용, 교육, 비상업 오픈소스, 직원 250명 미만이면서 매출 1,000만 달러 미만인 기업에 무료입니다. 그 외에는 연간 결제 기준 사용자당 월 Pro 9달러, Team 15달러, Business 24달러입니다. Docker Engine에서만 실행하면 Desktop 약관이 적용되지 않습니다.
- Docker MCP Gateway의 단점은 무엇입니까?
- 지금까지 보안 권고 10건, 2026년 7월에 critical 2건; Docker Engine에서 쓰려면 수동 설치와 우회가 필요; 외부 네트워크 접근이 기본으로 열려 있음; 모든 서버가 컨테이너 이미지여야 하며 일반 npx나 uvx는 불가.
- Docker MCP Gateway에 적합한 사람은 누구입니까?
- 이미 Docker를 쓰면서 여러 MCP 서버를 자기 컴퓨터의 격리되고 기록이 남는 단일 엔드포인트 뒤에 두고 싶은 개발자와 소규모 팀에 맞습니다.
- 팀이나 프로덕션 환경에서 Docker MCP Gateway의 비용은 얼마입니까?
- 소프트웨어는 무료입니다. Desktop 라이선스는 직원 250명 또는 매출 1,000만 달러부터 필요하며, 연간 결제 기준 사용자당 월 Pro 9달러, Team 15달러, Business 24달러입니다. 실행 중인 서버는 기본적으로 각각 최대 1 CPU와 2 GB를 확보하므로, --long-lived로 10개를 상주시키면 노트북 자원을 상당히 차지할 수 있습니다.
- Docker MCP Gateway에 회사 데이터를 맡겨도 안전합니까?
- 로컬에서 실행됩니다. 게이트웨이는 켜 둔 서버와 그 시크릿이 닿는 곳까지 닿으며, 게이트웨이 자체도 Docker 소켓이 필요한데 이는 표준 Linux 설치에서 root와 같은 권한입니다. Desktop에서는 게이트웨 이 지표가 Docker의 사용 분석으로 전송되며 Desktop 설정에서 끌 수 있습니다. Desktop이 없으면 텔레메트리 문서는 아무것도 내보내지 않는다고 설명합니다. 원격 서비스의 도구 출력은 시크릿 검사를 빼면 걸러지지 않고 모델에 전달됩니다.
- Docker MCP Gateway의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Composio, Pipedream MCP and Connect 및 mcp-server-docker입니다.
답변 확인일: 2026년 11월 11일.
Docker MCP Gateway 개발사입니까? 이 평점을 사이트에 표시하십시오
