Docker로 AI 개발 환경 구축하기 MCP Toolkit과 Model Runner

Docker는 MCP Catalog & Toolkit, Model Runner 기능을 추가하여 AI 개발 도구를 확장했습니다. Docker MCP Catalog & Toolkit은 MCP(Model Context Protocol) 도구들을 컨테이너로 패키징하여 제공하며 Claude Desktop, Cursor 등 AI 클라이언트와 연결됩니다. 기존 npx 명령어로 설치하던 방식 대신 Docker Desktop에서 원클릭으로 설치할 수 있습니다. Docker Model Runner는 llama.cpp 기반으로 AI 모델을 로컬에서 실행할 수 있습니다. OpenAI 호환 API를 제공하며 하드웨어 가속을 지원합니다.

본 게시글에서는 Docker 공식 문서를 참고하여 Docker Desktop 환경에서 GitHub과 Playwright MCP를 Claude Desktop과 연동해 사용해 보고 gpt-oss 모델을 이용한 채팅까지 테스트해 보겠습니다.

Docker MCP Catalog and Toolkit

  • MCP Catalog(카탈로그): 검증된 MCP 도구들을 중앙에서 관리·배포하는 저장소, 다양한 버전의 도구를 쉽게 검색·활용 가능

  • MCP Toolkit(툴킷): MCP 서버와 클라이언트 설치·관리를 위한 도구 모음, CLI/GUI로 MCP 도구를 추가·실행 가능

요구 사항

  • Docker Desktop 4.42.0 이상 설치 필요, 학습 센터는 4.46.0 이상 필요

테스트

  1. MCP Toolkit 선택

  2. Catalog 탭 선택

  3. 'GitHub Official' 검색

  4. + 를 선택하여 추가


  1. OAuth 선택

  2. authorize with the GitHub provider 선택


  • Authorize 진행

  1. Github 인증이 완료되면 다시 Catalog 탭으로 이동

  2. 'playwright' 를 검색

  3. + 를 선택하여 MCP 추가

    Mac OS X OS X OS X OS X OS X OS

  1. MCP Toolkit 탭 선택

  2. Clients 선택

  3. Claude Desktop > Connect 선택


  • Claude Desktop을 재시작한 후 다음 프롬프트를 사용해서 playwright 스크린샷 기능 테스트

Take a screenshot of the header element on docs.docker.com
  • 다음 프롬프트를 사용해서 GitHub 유저 정보 확인하는 기능 테스트

What's my GitHub handle?
Gibbons 계정 페이지의 스크린 샷

Docker Model Runner

  • Docker Model Runner(DMR): Docker 환경에서 AI 모델(모델, Model) 실행·관리·배포를 간편하게 해주는 도구

  • 하드웨어 가속 지원: 맥에서도 Metal을 통한 하드웨어 가속 지원

gpt-oss 모델 테스트

  1. Models 탭 선택

  2. Docker Hub 선택

  3. 원하는 모델 검색

  4. 해당 모델 Pull


  • 재생 버튼 선택

  • 채팅 테스트

결론

Docker의 MCP Catalog & Toolkit과 Docker Model Runner를 통해 AI 개발 환경이 획기적으로 단순화되었습니다.

주요 성과:

  • 통합 관리: MCP 도구들을 중앙 카탈로그에서 쉽게 검색하고 설치 가능

  • 원클릭 연동: Claude Desktop과 같은 AI 클라이언트와 즉시 연결

  • 모델 실행: Docker 환경에서 AI 모델을 컨테이너처럼 간단하게 실행

  • 하드웨어 최적화: Mac Metal 가속 등 플랫폼별 성능 최적화 지원

패러다임 변화: 이제 개발자들은 복잡한 환경 설정이나 의존성 관리에 시간을 낭비할 필요가 없습니다. AI 모델과 도구들이 Docker의 컨테이너 생태계에 통합되면서, 개발-테스트-배포의 모든 과정이 일관되고 간소화되었습니다.

미래 전망: Docker가 단순한 컨테이너 플랫폼에서 AI 개발의 통합 플랫폼으로 진화하고 있습니다. 앞으로는 인프라 복잡성을 걱정하지 않고 창의적인 AI 솔루션 개발에만 집중할 수 있는 환경이 현실화될 것으로 기대됩니다.

다음 단계:

  • ChatGPT MCP 설정을 통한 확장 테스트

  • DMR API 연동 애플리케이션 개발

  • Ollama, LM Studio와의 성능 비교 분석

6
지피터스 뉴스레터

이번 주 AI, 딱 쓸 것만

매주 월요일 아침,
읽고 바로 써먹을 AI 소식만