byteforce

CPN 한국어 자습서 · 외부 문서 한국어 미러

MCP 문서 · Registry

MCP 레지스트리 애그리게이터

MCP Registry Aggregators · 원문: modelcontextprotocol.io/registry/registry-aggregators

아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.

참고: MCP 레지스트리는 현재 프리뷰 단계입니다. 일반 공개 전까지 주요 변경 사항이나 데이터 초기화가 발생할 수 있습니다. 문제가 발생하면 GitHub에 보고해 주세요.

애그리게이터(aggregator)는 MCP 레지스트리의 다운스트림 소비자로서 추가적인 가치를 제공합니다. 예를 들어, 사용자 평점과 보안 스캐닝을 제공하는 서버 마켓플레이스가 이에 해당합니다.

MCP 레지스트리는 애그리게이터가 데이터 저장소를 채우는 데 사용할 수 있는 인증 없는 읽기 전용 REST API를 제공합니다. 애그리게이터는 정기적이지만 빈도를 낮춰 데이터를 스크레이핑하고(예: 시간당 1회), 데이터를 자체 데이터 저장소에 유지하는 것이 권장됩니다. MCP 레지스트리는 가동 시간이나 데이터 내구성을 보장하지 않습니다.

MCP 레지스트리 REST API 사용

MCP 레지스트리 REST API의 기본 URL은 https://registry.modelcontextprotocol.io입니다. 다음 엔드포인트를 지원합니다:

주의: serverName, version 등의 URL 경로 매개변수는 반드시(MUST) URL 인코딩되어야 합니다. 예를 들어, io.modelcontextprotocol/everything은 io.modelcontextprotocol%2Feverything으로 인코딩해야 합니다.

애그리게이터는 대부분 GET /v0.1/servers 엔드포인트를 스크레이핑합니다.

페이지네이션

GET /v0.1/servers 엔드포인트는 커서 기반 페이지네이션을 지원합니다.

예를 들어, 첫 번째 페이지는 limit 쿼리 매개변수를 사용하여 가져올 수 있습니다:

코드 · 명령
curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=100"
코드 · 명령
{
  "servers": [
    /* ... */
  ],
  "metadata": {
    "count": 100,
    "nextCursor": "com.example/my-server:1.0.0",
  },
}

이후 페이지는 nextCursor 값을 cursor 쿼리 매개변수로 전달하여 가져올 수 있습니다:

코드 · 명령
curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=100&cursor=com.example/my-server:1.0.0"

시간 기준 필터링

GET /v0.1/servers 엔드포인트는 특정 타임스탬프 이후 업데이트된 서버를 필터링하는 기능을 지원합니다.

예를 들어, 2025-10-23 이후 업데이트된 서버는 RFC 3339 날짜-시간 형식의 updated_since 쿼리 매개변수를 사용하여 가져올 수 있습니다:

코드 · 명령
curl "https://registry.modelcontextprotocol.io/v0.1/servers?updated_since=2025-10-23T00:00:00.000Z"

서버 상태

서버 메타데이터는 일반적으로 불변이지만, status 필드는 예를 들어 "deprecated" 또는 "deleted"로 업데이트될 수 있습니다. 애그리게이터는 각 서버의 status 사본을 최신 상태로 유지하는 것이 좋습니다.

"deleted" 상태는 일반적으로 서버가 관대한 콘텐츠 관리 정책을 위반했음을 나타내며, 해당 서버가 스팸, 악성 소프트웨어, 또는 불법 콘텐츠일 수 있음을 의미합니다. 애그리게이터는 이러한 서버를 인덱스에서 제거하는 것을 선호할 수 있습니다.

서브레지스트리로 동작하기

서브레지스트리는 MCP 레지스트리에서 정의한 OpenAPI 스펙도 구현하는 애그리게이터입니다. 이를 통해 MCP 호스트 애플리케이션 같은 클라이언트가 표준화된 인터페이스를 통해 서버 메타데이터를 사용할 수 있습니다.

서브레지스트리 OpenAPI 스펙은 _meta 필드를 통해 커스텀 메타데이터를 삽입할 수 있습니다. 예를 들어, 서브레지스트리는 사용자 평점, 다운로드 수, 보안 스캔 결과를 삽입할 수 있습니다:

코드 · 명령
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.username/email-integration-mcp",
  "title": "Email Integration",
  "description": "Send emails and manage email accounts",
  "version": "1.0.0",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "@username/email-integration-mcp",
      "version": "1.0.0",
      "transport": {
        "type": "stdio"
      }
    }
  ],
  "_meta": {
    "com.example.subregistry/custom": {
      "user_rating": 4.5,
      "download_count": 12345,
      "security_scan": {
        "last_scanned": "2025-10-23T12:00:00Z",
        "vulnerabilities_found": 0
      }
    }
  }
}

커스텀 메타데이터는 서브레지스트리를 반영하는 키 아래에 두는 것을 권장합니다(위 예시의 "com.example.subregistry/custom" 참조).

원문(영어): https://modelcontextprotocol.io/registry/registry-aggregators · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Model Context Protocol)에게 있습니다.

원문(영어): https://modelcontextprotocol.io/registry/registry-aggregators