К основному содержимому

Руководство по отправке локального MCP Server

Обновлено сегодня

Это полное руководство по отправке вашего локального сервера (MCPB) в публичный каталог Anthropic для более широкого распространения и обнаружения.

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

Перед прочтением этого руководства у вас должны быть:

  • Работающий MCPB

  • Портативный код с использованием подстановки переменных

  • Хорошие сообщения об ошибках и пользовательский опыт

  • Чистые, объединённые зависимости

Новичок в разработке MCPB? Сначала см. Building MCPB Extensions. Для технических лучших практик (тестирование, сообщения об ошибках, портативность) см. MCPB Repository.

Примечание: Это руководство охватывает локальные MCP серверы. Для удалённых расширений рабочего стола см. Remote MCP Server Submission Guide.


1. Обзор каталога

Каковы преимущества включения в каталог?

Обнаружение и доверие:

  • Размещение в официальном каталоге Anthropic в Claude Desktop

  • Поиск отдельными пользователями Claude Desktop

  • Видимость для пользователей Teams/Enterprise при добавлении в список разрешений администраторами

  • Проверка Anthropic повышает доверие пользователей

Пользовательский опыт:

  • Установка в один клик из каталога

  • Интеграция с пользовательским интерфейсом настроек Claude Desktop

  • Стандартизированное представление

Поддержка и авторитет:

  • Проверка качества и безопасности Anthropic

  • Размещение рядом с другими проверенными расширениями

  • Видимость в сообществе и обратная связь

  • Профессиональный канал распространения


2. Обязательные требования

Все требования в этом разделе являются обязательными для одобрения каталога. Отсутствие любого из них приведёт к отклонению или запросу на доработку.

Примечание: Это требования, специфичные для каталога Anthropic.

Для общих лучших практик разработки MCPB (тестирование, обработка ошибок, портативность) см. MCPB Repository README.


Требуются ли аннотации инструментов?

ДА. Каждый инструмент ДОЛЖЕН иметь и поддерживать точные аннотации безопасности.

Требуется для каждого инструмента:

  • readOnlyHint: true - Для инструментов, которые только читают данные

  • destructiveHint: true - Для инструментов, которые изменяют данные или имеют побочные эффекты

См. MCP Protocol - Tool Annotations для полной схемы и деталей реализации.

Не опционально. Это жёсткое требование, вытекающее из MCP Directory Policy.

Как выбрать аннотацию:

Поведение инструмента

Аннотация

Примеры

Только читает данные

readOnlyHint: true

search, get, list, fetch, read

Записывает/изменяет данные

destructiveHint: true

create, update, delete, send, write

Создаёт временные файлы

destructiveHint: true

Даже временные записи считаются

Отправляет внешние запросы

destructiveHint: true

Письма, уведомления, вебхуки

Кэширует только внутри

readOnlyHint: true

Внутренняя оптимизация OK

Детали реализации: См. MCP Protocol - Tools для:

  • Полная схема инструмента с аннотациями

  • Структура определения инструмента

  • Спецификации схемы входа/выхода

  • Дополнительные свойства инструмента (включая опциональное поле title)

Проверка перед отправкой:

# Проверить, что все инструменты имеют аннотации

grep -A 5 -B

Нашли ответ на свой вопрос?