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에서 직접 둘러볼 수 있어요:
- Docker Desktop에서 MCP Toolkit을 선택합니다.
- Catalog 탭을 선택해 사용 가능한 서버를 둘러봅니다.
- 서버를 선택하면 설명, 도구, 설정 옵션을 볼 수 있어요.
프로필에 서버 추가하기
카탈로그에서 프로필에 서버를 추가하려면:
- Catalog 탭에서 서버 옆의 체크박스를 선택합니다.
- 드롭다운에서 추가할 프로필을 선택합니다.
단계별 안내와 클라이언트 연결은 MCP Toolkit 시작하기 또는 MCP 프로필 문서를 참고해 주세요.
커스텀 카탈로그
커스텀 카탈로그를 사용하면 팀이나 조직을 위한 집중된 서버 모음을 만들 수 있어요. Docker 카탈로그의 300개 이상 서버를 모두 노출하는 대신, 정확히 어떤 서버를 사용할 수 있게 할지 정의할 수 있어요.
흔한 사용 사례:
- 조직에서 승인한 서버만 사용하도록 제한
- 공개 서버 옆에 조직의 비공개 MCP 서버 추가
- 팀이 사용할 서버 버전 제어
- Dynamic MCP를 사용하는 AI 에이전트가 사용할 수 있는 서버 집합 정의
Dynamic MCP와 커스텀 카탈로그
커스텀 카탈로그는 에이전트가 대화 중에 MCP 서버를 주문형으로 탐색하고 추가하는 Dynamic MCP와 특히 잘 맞아요. 커스텀 카탈로그로 게이트웨이를 실행하면 mcp-find 도구가 그 카탈로그 안에서만 검색해요. 카탈로그에 300개 이상 대신 20개의 서버가 있다면, 에이전트는 그 집중된 집합 안에서 작업하며 매번 수동 설정 없이 필요할 때 도구를 탐색하고 활성화해요.
커스텀 카탈로그 가져오기
팀원이 카탈로그를 만들어 공개했다면 OCI 레지스트리 참조로 가져올 수 있어요.
Docker Desktop에서:
- MCP Toolkit을 선택하고 Catalog 탭을 선택합니다.
- Import catalog를 선택합니다.
- 카탈로그의 OCI 참조를 입력합니다(예:
registry.example.com/mcp/team-catalog:latest). - 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 서버용).