modelcontextprotocol/registry

MCP Registry란 무엇인가요?

MCP Registry는 Model Context Protocol (MCP) 클라이언트가 MCP 호환 서버를 찾을 수 있도록 하는 공공 서비스로, 본질적으로 AI 모델 호스팅 엔드포인트를 위한 "앱 스토어"입니다. 안정적인 HTTP API(현재 v0.1)를 노출하여 큐레이션된 서버 설명자(server.json 파일) 목록을 반환하므로, 개발자는 프로그래밍 방식으로 모델 호스팅 서비스를 찾고 연결하며 상호 작용할 수 있습니다.

왜 중요한가요?

표준화된 검색 – 엔드포인트 URL을 하드코딩하는 대신, 도구는 레지스트리에 쿼리를 보내 최신 서버 메타데이터(기능, 인증 방법, 버전 관리 등)를 가져올 수 있습니다.
안전성 및 검증 – 레지스트리는 각 항목을 검증(GitHub OAuth, DNS/HTTP 소유권 증명)하여 악의적이거나 잘못 구성된 목록을 줄입니다.
생태계 조정 – 단일 진실 공급원(Single Source of Truth)을 제공함으로써, 레지스트리는 각 프로젝트가 자체 디렉토리를 유지할 필요 없이 서로 다른 MCP 프로젝트가 상호 운용될 수 있도록 돕습니다.

핵심 기능 (README 설명 기준)

기능	설명
API 고정 (v0.1)	공개 API는 1개월 동안 잠겨 있어 통합자가 안정적인 계약을 기반으로 개발할 수 있습니다.
Docker 기반 개발	`make dev-compose`를 통해 레지스트리와 PostgreSQL 인스턴스를 로컬에서 실행할 수 있습니다.
시드 데이터	서비스 시작 시 프로덕션 레지스트리의 필터링된 하위 집합을 미러링하여 현실적인 개발 환경을 보장합니다.
게시용 CLI	별도의 `mcp-publisher` 도구(`cmd/publisher`에서 빌드)가 서버 등록을 처리하며, GitHub OAuth, OIDC, DNS 또는 HTTP 챌린지를 통해 인증합니다.
인증	GitHub OAuth, GitHub OIDC (CI용), DNS 검증 및 HTTP 검증을 지원하여 네임스페이스 소유권을 증명합니다.
관측 가능성	메트릭 및 모니터링을 위한 내장 텔레메트리(`internal/telemetry` 참조).
코드형 인프라	배포 매니페스트는 `deploy/` (Pulumi)에 있습니다.
버전 관리 API 타입	공개 API 구조체는 `pkg/api/v0` 아래에 있어 향후 버전 관리가 간편합니다.

운영 주체

이 프로젝트는 여러 기업(Stacklok, PulseMCP, TeamSpark, Ravenmail)의 엔지니어로 구성된 Registry Working Group이 관리합니다. Discord, GitHub Discussions 및 공식 블로그를 통해 커뮤니티의 의견을 환영합니다.

시작하기

로컬 실행 – Docker, Go, ko를 설치한 후 make dev-compose를 실행하세요. 서비스는 http://localhost:8080에서 접속할 수 있습니다.
API 탐색 – 라이브 OpenAPI 문서는 https://registry.modelcontextprotocol.io/docs에서 호스팅됩니다.
서버 게시 – make publisher로 CLI를 빌드하고 docs/modelcontextprotocol-io/quickstart.mdx의 빠른 시작 가이드를 따르세요.
기여 – 포크(Fork)하여 변경 사항을 적용하고 PR을 제출하세요. 린팅 및 테스트는 make check를 통해 실행됩니다.

사용 사례

MCP 호환 모델 호스팅 서비스를 검색하거나 나열해야 하는 애플리케이션(클라이언트 라이브러리, UI 대시보드, AI 에이전트 오케스트레이션 플랫폼 등)을 구축 중이라면, 정적 목록을 유지하는 대신 MCP Registry를 참조하세요. 레지스트리의 검증 및 인증 메커니즘은 프로덕션 배포를 위한 신뢰할 수 있는 소스가 됩니다.

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 외부적인 가정은 포함되지 않았습니다.