Реестр MCP

Реестр MCP предоставляет клиентам MCP список серверов MCP, подобно магазину приложений для серверов MCP.

📤 Опубликовать мой сервер MCP | ⚡️ Документация API в реальном времени | 👀 Видение экосистемы | 📖 Полная документация

Статус разработки

Обновление от 24.10.2025: API реестра перешло в состояние заморозки API (v0.1) 🎉. В течение следующего месяца или дольше API останется стабильным без критических изменений, что позволит интеграторам уверенно внедрять поддержку. Эта заморозка применяется к v0.1, пока продолжается разработка v0. Мы будем использовать этот период для проверки API в реальных интеграциях и сбора отзывов для формирования v1 для общего доступа. Спасибо всем за ваш вклад и терпение — ваше участие стало ключевым фактором в достижении этого этапа!

Обновление от 08.09.2025: Реестр запущен в режиме предварительного просмотра 🎉 (анонс в блоге). Хотя система стала более стабильной, это все еще предварительный выпуск, и возможны критические изменения или сброс данных. Выпуск для общего доступа (GA) последует позже. Мы будем рады вашим отзывам в обсуждениях GitHub или в Discord #registry-dev (подробности присоединения здесь).

Текущие ключевые сопровождающие:

• Адам Джонс (Anthropic) @domdomegg

• Тадас Антанавичюс (PulseMCP) @tadasant

• Тоби Падилья (GitHub) @toby

• Радослав (Радо) Димитров (Stacklok) @rdimitrov

Участие в разработке

Мы используем несколько каналов для совместной работы — см. modelcontextprotocol.io/community/communication.

Часто (но не всегда) идеи проходят через этот конвейер:

• Discord — Обсуждения в сообществе в реальном времени

• Обсуждения — Предложение и обсуждение продуктовых/технических требований

• Задачи (Issues) — Отслеживание четко определенных технических задач

• Pull-запросы — Вклад в решение задач

Быстрый старт:

Предварительные требования

• Docker

• Go 1.24.x

• ko — Сборщик образов контейнеров для Go (инструкции по установке)

• golangci-lint v2.4.0

Запуск сервера

# Start full development environment
make dev-compose

Это запускает реестр на localhost:8080 с использованием PostgreSQL. База данных использует эфемерное хранилище и сбрасывается каждый раз при перезапуске контейнеров, обеспечивая чистое состояние для разработки и тестирования.

Примечание: Реестр использует ko для сборки образов контейнеров. Команда make dev-compose автоматически собирает образ реестра с помощью ko и загружает его в ваш локальный демон Docker перед запуском служб.

По умолчанию реестр заполняется данными из производственного API с отфильтрованным подмножеством серверов (чтобы ускорить запуск). Это гарантирует, что ваша локальная среда отражает поведение производства и все начальные данные проходят проверку. Для автономной разработки вы можете заполнить данные из файла без проверки с помощью MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose.

Настройку можно сконфигурировать с помощью переменных окружения в docker-compose.yml — см. .env.example для справки.

Предварительно собранные образы Docker автоматически публикуются в реестре контейнеров GitHub:

# 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)

• Разработка: main-<дата>-<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 или находиться в GitHub Action в репозиториях domdomegg

• me.adamjones/my-cool-mcp вы должны подтвердить владение adamjones.me через DNS или HTTP-запрос

Проекты сообщества

Ознакомьтесь с проектами сообщества, чтобы изучить примечательные работы, связанные с реестром, созданные сообществом.

Дополнительная документация

См. документацию для получения более подробной информации, если ваш вопрос не был здесь освещен!