Проверка загрузки и списка инструментов

Сервер запускается, но как убедиться, что он работает исправно? Давайте проверим, что он загружается, а ваш инструмент отображается там, где его видят клиенты. 🔍

В SDK есть вспомогательное средство для этого. Запуск команды mcp dev для вашего файла запускает сервер с подключённым визуальным инспектором.

В браузере откроется инспектор MCP — удобная панель для проверки сервера без написания кода клиента.

В инспекторе нажмите «Подключить». Это запускает рукопожатие; если оно пройдёт успешно, сервер загрузился и правильно взаимодействует по протоколу MCP.

Теперь перейдите на вкладку «Инструменты». Она вызывает операцию списка протокола и показывает все инструменты, о которых сообщает ваш сервер.

Вы должны увидеть там свою функцию по имени, например "hello" или "greet", вместе с описанием, взятым из её строки документации.

Нажмите на инструмент, и инспектор покажет его схему — параметры с типами, которые FastMCP создал на основе ваших аннотаций. Именно это читает модель.

Заполните аргументы и нажмите «Запустить». Инспектор вызовет ваш инструмент и покажет точный результат, который получила бы модель.

Если список инструментов пуст, вероятно, ваш декоратор не выполнился. Убедитесь, что @mcp.tool() находится непосредственно перед функцией.

Эта вкладка лишь предоставляет интерфейс к настоящему сообщению: клиент отправляет запрос tools/list, а сервер отвечает каталогом.

Инспектор предназначен не только для инструментов. В нём есть вкладки ресурсов и подсказок, поэтому можно проверить все возможности, которые предоставляет сервер.

Вы запустили mcp dev, подключились в инспекторе, увидели свой инструмент в списке и даже вызвали его в реальном времени. Ваш первый сервер действительно работает и проверен. Поздравляем! 🎉