Перейти к содержанию

Серверы

Машинный перевод

Эта страница переведена с английской документации автоматически, и основной версией остаётся английская страница. Если что-то читается неправильно, на странице Переводы объясняется, как об этом сообщить.

MCPServer предоставляет подключённому клиенту три примитива. Они различаются тем, кто решает их использовать:

  • Инструмент — это действие, которое выбирает и вызывает модель. Именно эта страница нужна большинству в первую очередь, а её справочный спутник — Структурированный вывод: всё о форме того, что возвращает инструмент.
  • Ресурс — это данные только для чтения, которые решает прочитать приложение. Его справочный спутник — Шаблоны URI: полный синтаксис адресации и правила безопасности путей.
  • Промпт — это шаблон сообщения, который человек вызывает по имени, из меню или слэш-командой.

Вокруг трёх примитивов — всё остальное, что объявляет сервер:

  • Автодополнение — серверное автодополнение аргументов промптов и шаблонов ресурсов.
  • Изображения, аудио и значки — всё, что инструмент может вернуть помимо текста, а также значки, которые клиент показывает рядом с вашим сервером.
  • Обработка ошибок объясняет разницу между ошибкой, после которой модель может восстановиться, и ошибкой, которую она не должна увидеть никогда.

Каждая страница здесь самодостаточна; переходите сразу к нужной. Если сервер ещё не написан, начните вместо этого с Первых шагов.

Что происходит внутри регистрируемых функций (объект Context, внедрение зависимостей, запрос у пользователя дополнительного ввода посреди вызова) — тема следующего раздела, Внутри обработчика.