/ 디렉터리 / 플레이그라운드 / MCP Registry
● 공식 modelcontextprotocol ⚡ 바로 사용

MCP Registry

제작: modelcontextprotocol · modelcontextprotocol/registry

MCP 서버를 위한 공식 카탈로그 및 조회 서비스 — 하나의 표준 소스에서 프로덕션 MCP를 발견하고, 퍼블리시하고, 검증.

MCP Registry는 Anthropic이 공식 승인한 MCP 서버 목록으로, 프로토콜의 npm/PyPI에 해당합니다. REST API, Go 서버, 자체 MCP를 퍼블리시하기 위한 도구를 제공합니다. 기능, 언어, 퍼블리셔별로 MCP를 발견하려는 클라이언트의 업스트림 정보원 역할을 합니다.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

mcp-registry.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-registry",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-registry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/registry-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add mcp-registry -- npx -y @modelcontextprotocol/registry-mcp

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: MCP Registry

Claude가 공식 레지스트리를 검색하여 작업에 맞는 MCP 찾기

👤 무엇을 하고 싶은지는 알지만 어떤 MCP가 하는지 모르는 모든 사람 ⏱ ~10 min beginner

언제 쓸까: Postgres MCP / Notion MCP 등이 필요하고 표준적인 선택을 원할 때.

흐름
  1. 검색
    Use registry MCP. Find the top 3 results for keyword 'postgres' and tell me their stars + last update.✓ 복사됨
    → 메타데이터가 있는 세 가지 후보
  2. 매니페스트 검사
    For each, show config + tool list so I can pick.✓ 복사됨
    → 매니페스트 렌더링
  3. 선택한 것 설치
    Install the top result into Claude Desktop.✓ 복사됨
    → claude_desktop_config.json에 설정 블록 작성

결과: 무작위 검색 결과가 아닌 권위 있는 소스에서 선택된 MCP.

함정
  • 최신 MCP가 아직 등록되지 않았을 수 있음 — 커뮤니티 기반 선택을 위해 FreeMCPLab과 직접 GitHub 교차 확인

자신의 MCP를 공식 레지스트리에 퍼블리시하여 발견 가능하게 만들기

👤 안정적이고 유용한 서버를 가진 MCP 개발자 ⏱ ~30 min intermediate

언제 쓸까: MCP에 3명 이상의 사용자가 있고 발견 가능성을 원할 때.

사전 조건
  • 매니페스트가 있는 GitHub 레포 — 레지스트리 스키마를 따르는 레포 루트의 server.json
흐름
  1. 매니페스트 검증
    Use registry MCP to validate my server.json against the official schema. Tell me what's missing.✓ 복사됨
    → 스키마 검증 보고서
  2. 제출
    Submit via the registry CLI. Auth using my GitHub identity.✓ 복사됨
    → 제출 수락, URL 반환
  3. 발견 가능성 검증
    Search for my MCP by name; confirm it appears.✓ 복사됨
    → 검색에서 표시

결과: 공식 레지스트리에 등록된 자신의 MCP.

회사를 위한 내부 MCP 레지스트리 운영

👤 내부 MCP가 있는 조직의 플랫폼 팀 ⏱ ~60 min advanced

언제 쓸까: 공개 레지스트리에 올리고 싶지 않은 독점 MCP가 있을 때.

사전 조건
  • Go 런타임 또는 Docker — go install 또는 docker pull
흐름
  1. 서버 실행
    Start the registry server on internal.mcp.corp. Configure auth.✓ 복사됨
    → 서버 가동, 읽기 가능한 스키마 엔드포인트
  2. 미러 또는 큐레이션
    Mirror selected public entries; add private ones from internal teams.✓ 복사됨
    → 하이브리드 카탈로그
  3. Claude에 연결
    Configure Claude Desktop to use the internal registry URL for discovery.✓ 복사됨
    → 발견에 내부 소스 사용

결과: 자체 레지스트리를 통해 관리되고 발견되는 내부 MCP.

조합

다른 MCP와 조합해 10배 효율

SDK + 레지스트리 — 구축 후 퍼블리시

Build with mcp-python-sdk; once stable, validate via registry MCP and submit.✓ 복사됨

레지스트리와 큐레이션된 awesome 목록 교차 참조

If a server isn't in the registry yet, check the awesome list for community status.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
search_servers query, runtime?, limit? 발견 0
get_server id 상세 페이지 0
validate_manifest manifest_json 제출 전 확인 0
submit_server manifest, github_token 자신의 MCP 퍼블리시 0

비용 및 제한

운영 비용

API 쿼터
공개 읽기는 인증 불필요; 제출은 GitHub 인증 필요
호출당 토큰
작음 — 매니페스트는 JSON
금액
무료
클라이언트 측에서 매니페스트 결과를 캐시; 자주 변경되지 않음

보안

권한, 시크릿, 파급범위

최소 스코프: github:read (for submission)
자격 증명 저장: 제출 전용으로 환경 변수에 GitHub token 저장
데이터 외부 송신: registry.modelcontextprotocol.io
절대 부여 금지: github:write to private orgs

문제 해결

자주 발생하는 오류와 해결

스키마 검증 실패

server.json을 /schemas의 표준 스키마와 비교; 누락된 필드가 흔함

제출 거부

GitHub 신원이 매니페스트 퍼블리셔와 일치하는지 확인; 레포가 공개인지 확인

제출 후 서버가 보이지 않음

인덱싱에 몇 분이 걸릴 수 있음; 5분 후 검색 새로고침

대안

MCP Registry 다른 것과 비교

대안언제 쓰나단점/장점
Smithery / PulseMCP세련된 상업 디렉토리를 원할 때서드파티 인덱스; 이것이 업스트림
FreeMCPLab (this site)원시 카탈로그보다 큐레이션된 가이드와 실습 데모를 원할 때다른 형태 — 플레이그라운드 vs 인덱스

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기