Перейти к основному содержимому
Открыть Markdown

Каталог и реестр

Каталог и официальный реестр MCP — два способа подготовить исходное определение Hosted MCP. Каталог содержит определения, курируемые для текущей инсталляции Just Run. Результаты из реестра поступают из внешнего индекса сообщества, и перед запуском их необходимо проверить.

После создания ни один источник не остается привязанным к исходному определению. Just Run копирует поля, нужные для развертывания, в обычный инстанс Hosted MCP, которым дальше управляете вы.

Ментальная модель​

Catalog entry ───────────────┐
├──► copied definition ──► Hosted MCP instance
Official Registry result ────┘ ├── source
├── package и version
├── arguments
└── environment requirements

catalog_key и registry_ref сохраняют сведения о происхождении. Они не заставляют инстанс следовать за последующими изменениями каталога или реестра. Повторное развертывание использует определение, которое сейчас хранится на инстансе.

Сравнение источников​

СвойствоКаталогОфициальный реестр MCP
Кто поддерживаетИнсталляция Just RunВнешние издатели реестра
Проверка продуктомКурируется для инсталляцииНепроверенное содержимое сообщества
Типы источниковЛюбой источник, поддерживаемый записью каталогаnpm- и PyPI-пакеты со stdio, пригодные для размещения
Результат выбораСервер заполняет источник, пакет и аргументы по умолчаниюИнтерфейс заполняет редактируемое определение собственного сервера
Метаданные переменных окруженияОбязательные и необязательные поля из записиПодсказки об обязательных, необязательных и чувствительных полях и значения по умолчанию из исходного реестра
ДоступностьДоступен вместе с MCP-хостингомМожет быть отдельно отключен или временно недоступен
Будущие обновленияНе применяются к существующим инстансамНе применяются к существующим инстансам

Используйте каталог как самый короткий проверенный старт. Реестр подходит для более широкого поиска, если вы готовы проверить издателя, репозиторий, пакет, аргументы и запрашиваемые учетные данные.

Как работает каталог​

Веб-интерфейс открывает вкладку Каталог после выбора Новый MCP-сервер на странице MCP-хостинг. На каждой карточке могут отображаться:

  • источник и пакет записи;
  • краткое описание и ссылка на документацию;
  • количество обязательных переменных окружения.

Выбор карточки сохраняет ее catalog_key. При создании сервер читает текущую видимую запись и заполняет source, package и непустые аргументы по умолчанию. Клиент API может явно переопределить эти поля, но веб-интерфейс фиксирует курируемые поля запуска во время создания.

Обязательные поля переменных окружения нужно передать напрямую, если не подключена хотя бы одна ссылка на секрет. Ссылка на секрет обходит эту проверку ключей при создании. Во время развертывания Just Run проверяет, что каждый указанный секрет существует, имеет тип env и может быть объединен, но не сравнивает итоговые ключи с метаданными каталога. Убедитесь, что подключенные секреты действительно содержат все обязательные переменные; иначе сервер может завершиться ошибкой при запуске или MCP handshake.

Записи каталога — данные конкретной инсталляции. Их имена и содержимое могут меняться при обновлении инсталляции, а скрытые записи не возвращаются. Вместо зависимости от жестко заданного списка проверяйте текущие карточки или GET /v1/hosted-mcp/catalog.

Как работает реестр​

Вкладка Реестр в форме Новый MCP-сервер просматривает официальный реестр MCP и выполняет по нему поиск через аутентифицированный эндпоинт Just Run. Результаты разбиты на страницы с курсором. Предлагаются только записи, которые текущая среда выполнения Hosted MCP может преобразовать в локальный сервер:

  • npm-пакеты с транспортом stdio становятся источниками npx;
  • PyPI-пакеты с транспортом stdio становятся источниками uvx;
  • если запись предлагает оба варианта, приоритет получает npm-пакет;
  • исключаются определения, которые доступны только как удаленный сервер, только как образ OCI или Docker либо используют неподдерживаемый транспорт, а также пакеты с недопустимыми именами.

У просмотра реестра есть собственный переключатель в конфигурации инсталляции, независимый от MCP-хостинга. Если он отключен, вкладка объясняет недоступность возможности, а API возвращает HTTP 503.

Результаты кешируются по поисковому запросу и курсору. При сбое исходного реестра может быть возвращена недавняя устаревшая копия; если подходящей кешированной копии нет, запрос возвращает HTTP 503. Поэтому поиск по реестру — средство обнаружения, а не подтверждение в реальном времени состояния публикации пакета.

Что копирует импорт​

После выбора результата из реестра открывается обычная форма собственного сервера, которая предварительно заполняет:

  • npx или uvx как источник;
  • имя пакета и опубликованную версию;
  • описания полей переменных окружения, пометки об обязательности, подсказки о чувствительности и непустые значения по умолчанию;
  • документированные аргументы пакета как видимые подсказки;
  • предложенное имя инстанса;
  • registry_ref в формате <registry-name>@<version>.

Проверяйте каждое поле до создания инстанса. Аргументы пакета не добавляются автоматически. Значения переменных окружения по умолчанию могут быть заполнены заранее, но метаданные исходного реестра не доказывают, что значение безопасно или все еще правильно. Все поля запуска остаются редактируемыми; registry_ref — только справочные сведения о происхождении.

Официальный реестр не означает доверенный код

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

Когда выбрать другой путь​

  • Выберите собственный сервер, если пакет уже известен или нужны явная команда либо HTTP-сервер, который сам предоставляет MCP.
  • Выберите обычную песочницу, если рабочей нагрузке нужны сборка, загруженные исходные файлы, интерактивная среда или несколько сервисов помимо одного управляемого MCP-эндпоинта.