MCP 레지스트리

Get it on MCP Marketplace

MCP 레지스트리는 MCP 클라이언트에게 MCP 서버 목록을 제공하며, MCP 서버를 위한 앱 스토어와 같은 역할을 합니다.

📤 내 MCP 서버 게시하기 | ⚡️ 라이브 API 문서 | 👀 생태계 비전 | 📖 전체 문서

개발 현황

2025-10-24 업데이트: 레지스트리 API가 API 동결(v0.1) 상태에 진입했습니다 🎉. 향후 한 달 이상 API는 변경 사항 없이 안정적으로 유지되어 통합 담당자가 안심하고 지원을 구현할 수 있게 됩니다. 이 동결은 v0 개발이 계속되는 동안 v0.1에 적용됩니다. 이 기간을 활용하여 실제 통합 환경에서 API를 검증하고 피드백을 수집하여 정식 출시를 위한 v1을 구체화할 예정입니다. 기여해 주신 모든 분과 인내심을 가져주신 분들께 감사드립니다. 여러분의 참여가 여기까지 오는 데 핵심적인 역할을 했습니다!

2025-09-08 업데이트: 레지스트리가 프리뷰 버전으로 출시되었습니다 🎉 (공지 블로그 게시물). 시스템이 더욱 안정화되었지만, 여전히 프리뷰 릴리스이므로 주요 변경 사항이나 데이터 초기화가 발생할 수 있습니다. 정식 출시(GA)는 추후 진행될 예정입니다. GitHub 토론 또는 #registry-dev Discord (참여 방법은 여기)를 통해 피드백을 주시면 감사하겠습니다.

현재 주요 관리자:

Adam Jones (Anthropic) @domdomegg
Tadas Antanavicius (PulseMCP) @tadasant
Toby Padilla (GitHub) @toby
Radoslav (Rado) Dimitrov (Stacklok) @rdimitrov

기여 방법

협업을 위해 여러 채널을 사용하고 있습니다. modelcontextprotocol.io/community/communication을 참조하세요.

아이디어는 종종(항상 그렇지는 않지만) 다음 파이프라인을 통해 흐릅니다:

Discord - 실시간 커뮤니티 토론
Discussions - 제품/기술 요구 사항 제안 및 토론
Issues - 범위가 명확한 기술 작업 추적
Pull Requests - 이슈 해결을 위한 작업 기여

빠른 시작:

사전 요구 사항

Docker
Go 1.24.x
ko - Go용 컨테이너 이미지 빌더 (설치 지침)
golangci-lint v2.4.0

서버 실행

# Start full development environment
make dev-compose

이 명령은 PostgreSQL과 함께 localhost:8080에서 레지스트리를 시작합니다. 데이터베이스는 임시 스토리지를 사용하며 컨테이너를 다시 시작할 때마다 초기화되므로 개발 및 테스트를 위한 깨끗한 상태가 보장됩니다.

참고: 레지스트리는 ko를 사용하여 컨테이너 이미지를 빌드합니다. make dev-compose 명령은 자동으로 ko를 사용하여 레지스트리 이미지를 빌드하고 서비스를 시작하기 전에 로컬 Docker 데몬에 로드합니다.

기본적으로 레지스트리는 프로덕션 API에서 필터링된 서버 하위 집합을 시드(seed)로 사용합니다(시작 속도를 유지하기 위함). 이를 통해 로컬 환경이 프로덕션 동작을 반영하고 모든 시드 데이터가 유효성 검사를 통과하도록 보장합니다. 오프라인 개발의 경우 MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose를 사용하여 유효성 검사 없이 파일에서 시드할 수 있습니다.

설정은 docker-compose.yml의 환경 변수로 구성할 수 있습니다. 참조는 .env.example을 확인하세요.

미리 빌드된 Docker 이미지는 GitHub Container Registry에 자동으로 게시됩니다:

# Run latest stable release
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest

# Run latest from main branch (continuous deployment)
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main

# Run specific release version
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0

# Run development build from main branch
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d

사용 가능한 태그:

릴리스: latest, v1.0.0, v1.1.0 등
연속: main (최신 메인 브랜치 빌드)
개발: main-<date>-<sha> (특정 커밋 빌드)

서버 게시

서버를 게시하기 위해 간단한 CLI를 만들었습니다. 다음 명령으로 사용할 수 있습니다:

# Build the latest CLI
make publisher

# Use it!
./bin/mcp-publisher --help

자세한 내용은 게시자 가이드를 참조하세요.

기타 명령어

# Run lint, unit tests and integration tests
make check

개발에 도움이 되는 몇 가지 명령어가 더 있습니다. 자세한 내용을 보려면 make help를 실행하거나 Makefile을 확인하세요.

아키텍처

프로젝트 구조

├── cmd/                     # Application entry points
│   └── publisher/           # Server publishing tool
├── data/                    # Seed data
├── deploy/                  # Deployment configuration (Pulumi)
├── docs/                    # Documentation
├── internal/                # Private application code
│   ├── api/                 # HTTP handlers and routing
│   ├── auth/                # Authentication (GitHub OAuth, JWT, namespace blocking)
│   ├── config/              # Configuration management
│   ├── database/            # Data persistence (PostgreSQL)
│   ├── service/             # Business logic
│   ├── telemetry/           # Metrics and monitoring
│   └── validators/          # Input validation
├── pkg/                     # Public packages
│   ├── api/                 # API types and structures
│   │   └── v0/              # Version 0 API types
│   └── model/               # Data models for server.json
├── scripts/                 # Development and testing scripts
├── tests/                   # Integration tests
└── tools/                   # CLI tools and utilities
    └── validate-*.sh        # Schema validation tools

인증

게시는 여러 인증 방법을 지원합니다:

GitHub OAuth - GitHub에 로그인하여 게시
GitHub OIDC - GitHub Actions에서 게시
DNS 검증 - 도메인 및 하위 도메인의 소유권 증명
HTTP 검증 - 도메인 소유권 증명

레지스트리는 게시 시 네임스페이스 소유권을 검증합니다. 예를 들어...를 게시하려면:

io.github.domdomegg/my-cool-mcp를 게시하려면 GitHub에 domdomegg로 로그인하거나 domdomegg의 리포지토리에서 GitHub Action을 실행해야 합니다.
me.adamjones/my-cool-mcp를 게시하려면 DNS 또는 HTTP 챌린지를 통해 adamjones.me의 소유권을 증명해야 합니다.

커뮤니티 프로젝트

커뮤니티 프로젝트를 확인하여 커뮤니티에서 만든 주목할 만한 레지스트리 관련 작업을 살펴보세요.

추가 문서

여기에 질문에 대한 답변이 없는 경우 문서에서 자세한 내용을 확인하세요!

meridian-edge-mcp