Docker MCP 카탈로그

Docker MCP 카탈로그

Docker MCP 카탈로그는 검증된 MCP 서버를 선별해 Docker 이미지로 패키징하고 Docker Hub를 통해 배포한 모음이에요. 로컬에서 MCP 서버를 실행할 때 생기는 공통적인 문제인 환경 충돌, 설정 복잡성, 보안 우려를 해결해 줘요.

출처: 문서

본문

가용성: Beta

카탈로그는 사용 가능한 MCP 서버의 원천(source) 역할을 해요. 프로필에 서버를 추가할 때 카탈로그에서 고르게 되죠. 각 서버는 격리된 컨테이너로 실행되므로 서로 다른 환경에서도 이식 가능하고 일관되게 동작해요.

참고: 이제 E2B 샌드박스에는 Docker MCP 카탈로그에 대한 직접 접근이 포함되어, 개발자가 200개 이상의 도구와 서비스에 접근해 AI 에이전트를 원활하게 빌드하고 실행할 수 있어요. 자세한 내용은 E2B 샌드박스 문서를 참고해 주세요.

카탈로그에 포함된 것

Docker MCP 카탈로그에는 다음이 포함돼요:

  • 검증된 서버(Verified servers): 모든 서버가 전체 출처(provenance)와 SBOM 메타데이터와 함께 버전 관리돼요.
  • 파트너 도구(Partner tools): New Relic, Stripe, Grafana 등 신뢰할 수 있는 파트너의 서버.
  • Docker가 만든 서버(Docker-built servers): 보안 강화를 위해 Docker가 빌드하고 디지털 서명한 로컬 실행 서버.
  • 원격 서비스(Remote services): GitHub, Notion, Linear 같은 외부 서비스에 연결하는 클라우드 호스팅 서버.

로컬 서버와 원격 서버

카탈로그에는 실행 위치에 따라 두 가지 유형의 서버가 있어요.

로컬 서버(Local servers) 는 내 머신에서 컨테이너로 실행돼요. 다운로드 후에는 오프라인으로도 동작하고, 예측 가능한 성능과 완전한 데이터 프라이버시를 제공해요. 카탈로그의 모든 로컬 서버는 Docker가 빌드하고 서명해요.

원격 서버(Remote servers) 는 제공업체 인프라에서 실행되며 외부 서비스에 연결돼요. 많은 원격 서버가 OAuth 인증을 사용하는데, MCP Toolkit이 브라우저를 통해 자동으로 처리해 줘요.

카탈로그 둘러보기

사용 가능한 MCP 서버는 hub.docker.com/mcp에서 또는 Docker Desktop에서 직접 둘러볼 수 있어요:

  1. Docker Desktop에서 MCP Toolkit을 선택합니다.
  2. Catalog 탭을 선택해 사용 가능한 서버를 둘러봅니다.
  3. 서버를 선택하면 설명, 도구, 설정 옵션을 볼 수 있어요.

프로필에 서버 추가하기

카탈로그에서 프로필에 서버를 추가하려면:

  1. Catalog 탭에서 서버 옆의 체크박스를 선택합니다.
  2. 드롭다운에서 추가할 프로필을 선택합니다.

단계별 안내와 클라이언트 연결은 MCP Toolkit 시작하기 또는 MCP 프로필 문서를 참고해 주세요.

커스텀 카탈로그

커스텀 카탈로그를 사용하면 팀이나 조직을 위한 집중된 서버 모음을 만들 수 있어요. Docker 카탈로그의 300개 이상 서버를 모두 노출하는 대신, 정확히 어떤 서버를 사용할 수 있게 할지 정의할 수 있어요.

흔한 사용 사례:

  • 조직에서 승인한 서버만 사용하도록 제한
  • 공개 서버 옆에 조직의 비공개 MCP 서버 추가
  • 팀이 사용할 서버 버전 제어
  • Dynamic MCP를 사용하는 AI 에이전트가 사용할 수 있는 서버 집합 정의

Dynamic MCP와 커스텀 카탈로그

커스텀 카탈로그는 에이전트가 대화 중에 MCP 서버를 주문형으로 탐색하고 추가하는 Dynamic MCP와 특히 잘 맞아요. 커스텀 카탈로그로 게이트웨이를 실행하면 mcp-find 도구가 그 카탈로그 안에서만 검색해요. 카탈로그에 300개 이상 대신 20개의 서버가 있다면, 에이전트는 그 집중된 집합 안에서 작업하며 매번 수동 설정 없이 필요할 때 도구를 탐색하고 활성화해요.

커스텀 카탈로그 가져오기

팀원이 카탈로그를 만들어 공개했다면 OCI 레지스트리 참조로 가져올 수 있어요.

Docker Desktop에서:

  1. MCP Toolkit을 선택하고 Catalog 탭을 선택합니다.
  2. Import catalog를 선택합니다.
  3. 카탈로그의 OCI 참조를 입력합니다(예: registry.example.com/mcp/team-catalog:latest).
  4. Import를 선택합니다.

CLI로:

$ docker mcp catalog pull <oci-reference>

가져오면 카탈로그가 Docker 카탈로그 옆에 나타나고, 그 서버를 프로필에 추가할 수 있어요.

커스텀 카탈로그 생성과 관리

커스텀 카탈로그를 만들고 관리하려면 CLI가 필요해요. 단계별 안내는 CLI how-to 문서의 커스텀 카탈로그를 참고해 주세요. 여기에는 다음이 포함돼요:

  • Docker 카탈로그의 하위 집합 선별
  • 카탈로그에 비공개 서버 추가
  • 처음부터 집중된 카탈로그 구축
  • 팀이 가져올 수 있도록 카탈로그를 레지스트리에 푸시

카탈로그에 MCP 서버 기여하기

MCP 서버 레지스트리는 https://github.com/docker/mcp-registry에서 확인할 수 있어요. MCP 서버를 제출하려면 기여 가이드라인을 따르세요.

풀 리퀘스트가 검토되고 승인되면 24시간 이내에 다음에서 MCP 서버를 사용할 수 있어요:

  • Docker Desktop의 MCP Toolkit 기능.
  • Docker MCP 카탈로그.
  • Docker Hub의 mcp 네임스페이스(Docker가 만든 MCP 서버용).

더 알아보기 (Learn more)