Запуск сервера через stdio

У вас уже есть объект сервера и инструмент. Теперь нужно действительно его запустить, чтобы клиент мог подключиться и использовать созданные вами возможности. 🏃

Простейший транспорт — стандартные ввод и вывод: stdio. Клиент запускает ваш скрипт и взаимодействует с ним через эти два потока.

Запуск сервера выполняется одним методом. Вызов mcp.run() передаёт управление FastMCP, который сразу начинает ожидать сообщения.

Передайте аргумент транспорта, чтобы явно указать его. Для локального использования нужен "stdio"; он также выбирается по умолчанию при вызове run.

Оберните вызов в классическую проверку __main__. Тогда сервер запустится только при непосредственном запуске файла, а не при его импорте.

Вот полный сервер: импорт, экземпляр, инструмент и запуск. Всего несколько строк — и он поддерживает MCP.

Есть одно важное правило: никогда не используйте print для стандартного вывода. Этот поток содержит сообщения протокола, и посторонний текст повредит их.

Нужно отладить программу? Записывайте данные в stderr, а не в stdout. Клиент игнорирует stderr, поэтому ваши заметки не попадут в поток протокола.

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

После run() сервер блокируется, ожидая сообщения. Он не завис — он ожидает следующий запрос от клиента.

Помните, что stdio работает только на одном компьютере, поскольку использует запущенный процесс. Для удалённых серверов применяется транспорт HTTP, с которым вы познакомитесь позже.

Вы запустили сервер с помощью mcp.run() через stdio, поместили его в проверку __main__ и не засоряли stdout. Сервер работает и ожидает сообщения. Давайте убедимся, что всё работает! ✅