본문 바로가기
AI

[바이브 코딩] Docker MCP Toolkit 아세요?

by 개발자의 2025. 9. 4.

스프링 부트 버전이 올라가면서 도커 컴포즈를 지원해주고 있다.

그 때문에 개발에 사용하기 위해 도커 데스크톱을 깔아 뒀는데, 우연히 MCP Toolkit (Beta) 항목을 발견했다.

 

(뭐 눈에는 뭐만 보인다고.. 관심 없을 때는 쳐다도 안 보던...)

Docker Desktop MCP Toolkit Catalog tab
Docker Desktop MCP Toolkit Catalog tab

 

뭔가 느낌적으로 카탈로그에 있는 MCP 들을 사용할 수 있을 것 같다는 본능적인 느낌이 든다.

클라이언트 탭을 확인해 보면, 도커 툴킷에서 여러 가지 클라이언트를 연결해서 사용할 수 있는 듯하다.

Docker Desktop MCP Toolkit Clients Tab
Docker Desktop MCP Toolkit Clients Tab

내 생각이 맞다면, 

터미널로 LLM을 사용하면서 IDE랑 상관없이 AI를 사용할 수 있게 된 것처럼,

MCP도 한 번만 설치하면 어디든 쓸 수 있겠다는 생각이다.

바이브 코딩 환경 변화 과정
바이브 코딩 환경 변화 과정

 

클로드 코드도 깔아보고, 제미나이도 깔아봤는데, 설치하는 건 그렇다 치고,

MCP 연동을 매번 해줘야 하는 것도 꽤나 귀찮은 작업인 건 사실이다.

이 툴로 MCP 연동 작업을 줄일 수 있다면 좋겠다!

 

(더 실력 좋으신 개발자분들은 MCP proxy 서버를 스펙에 맞춰 만들어 쓸 수도 있지만, 내 생각에는 그것도 일이라서.... 과감하게 패스!)

 

사용법은 간단하다.

0) 사전준비

도커 데스크톱은 무조건 깔려 있어야 한다.

 

윈도의 경우에는 예전에 포스팅해 둔 글이 있는데..

2020.10.02 - [Docker] - [Docker] Hyper-V 없이 Docker for Windows 사용하기

 

[Docker] Hyper-V 없이 Docker for Windows 사용하기

언젠가 도커 업데이트를 하면서 WSL2로 업데이트해라? 이런 안내를 보고 적용했는데, 자세히 알아보니 WSL이 Windows Subsystem for Linux라고 간단히 말해서 윈도우에서 리눅스 환경을 사용할수 있게 해

lazymolt.tistory.com

 

맥의 경우에는 아래와 같이 설치

brew install --cask docker

설치 후 아래와 같이 실행하면 설치 완료.

open /Applications/Docker.app

설치 확인

docker --version

1) Docker MCP Toolkit에 MCP 설치

Docker Desktop MCP Toolkit에 원하는 MCP Server들을 설치한다.

대표적으로 Sequential Thinking MCP 설치는 아래 이미지 처럼 하면 된다.

설치 전에는 '+' 모양이 설치 후에는 휴지통 모양이 된다.

MCP 설치 시 API Key가 필요치 않은 것들은 특별한 설정 없이 바로 추가된다.

Sequential Thinking MCP 설치 전Sequential Thinking MCP 설치 후
Docker MCP Toolkit MCP 설치 전 / 후

위와 같은 방식으로 필요한 MCP 들을 설치하고 나면, 아래와 같이 Servers 탭에 설치한 MCP들의 목록을 확인할 수 있다.

Docker MCP Toolkit 설치된 MCP 목록

제대로 설치되었는지 확인해 보자

# 도커 MCP 서버에 설치된 목록 조회
docker mcp server list

# 도커 MCP 서버에서 사용 가능한 툴 목록 조회
docker mcp tools list --format list

아래와 같이 설치된 MCP 목록과 사용 가능한 툴의 목록을 확인할 수 있다.

도커에 설치된 MCP 서버 / 툴 확인
도커에 설치된 MCP 서버 / 툴 확인

 

2) Docker MCP Toolkit과 클라이언트(Gemini-cli) 연결

이제 Docker MCP Toolkit에 필요한 MCP 들은 모두 설정했고, 내가 사용할 클라이언트(Gemini-cli)와 연결해 보자.

간단하게 클라이언트 탭에서 Connect 버튼을 눌러서 연결하자. PC에 사용할 수 있는 클라이언트가 설치되어 있으면 Connect 버튼이 파랗게 활성화된다.

 

연결이 되면 버튼이 Disconnect로 변경된다. 연결 해제 시에는 간단하게 Disconnect 버튼을 누르면 된다.

도커 데스크탑 MCP Toolkit 클라이언트 연동
도커 데스크탑 MCP Toolkit 클라이언트 연동

연결되면 settings.json에 아래 mcpServers :{...} 안에 아래 블록이 자동으로 추가된다.

{
  // ... 생략
  "mcpServers":{
    "MCP_DOCKER":{
      "command":"docker",
      "args":["mcp","gateway","run"]
    }
  }
  // ... 생략
}

 

이제 Gemini-cli 실행 후 확인해 보자

샌드박스 실행!

gemini -s

 

Gemini-cli MCP Toolkit 연동 확인
Gemini-cli MCP Toolkit 연동 확인

MCP 서버는 1개 연결되어 있지만, Ctrl + T 또는 /mcp desc 명령어 실행하면 아래와 같이 설치된 MCP와 MCP의 tool 들을 확인할 수 있다.

Gemini-cli MCP Toolkit MCP Tools 확인
Gemini-cli MCP Toolkit MCP Tools 확인

MCP_DOCKER MCP 하나에 168개의 툴들이 등록되어 있는 것을 확인할 수 있다!

 

물론 100 퍼센트 좋은 점만 있는 건 아니다.

아직 Beta 버전이라는 것도 불안요소 중 하나이고, 카탈로그에 없는 MCP를 연동하는 것은 힘들어 보인다.

하지만, LLM에 따라서 MCP 설정을 여러 번 하지 않아도 된다는 건 분명한 장점이다.

 

끄읕!