MCP на Python: создаём свой сервер инструментов

🧭 Отправная точка

Клиент находит инструмент calculate_delivery_cost на MCP-сервере и вызывает его, но возвращённая стоимость доставки отличается от ожидаемой. Чтобы разобраться, нужно проверить аргументы запроса, данные о тарифе и результат вычисления. Такой случай вы самостоятельно исследуете в конце курса.

MCP (Model Context Protocol) позволяет приложениям получать список доступных инструментов и вызывать их через единый протокол. На курсе вы создадите два небольших MCP-сервера на Python, напишете клиентов для работы с ними и научитесь проверять успешные и ошибочные вызовы.

Сначала вместе с курсом разработаете сервер заказов: поиск заказа по идентификатору и расчёт его стоимости. Затем самостоятельно создадите сервер доставки с поиском тарифа и расчётом цены по зоне и весу. У каждого сервера будет своя логика и локальный JSON-файл с данными.

🎯 Цель курса — научиться самостоятельно создавать MCP-инструменты, подключать к ним Python-клиентов, находить ошибки и подтверждать правильность работы тестами.

⚙️ Что вы будете делать

• ⚙️ Создавать MCP-серверы и инструменты. Зарегистрируете функции get_order и calculate_order_total для заказов, затем самостоятельно реализуете get_tariff и calculate_delivery_cost для доставки. Разберёте аргументы, возвращаемые значения и чтение данных из JSON.

• 🔗 Подключать MCP-клиентов. Напишете Python-клиентов, которые получают список инструментов и вызывают их с нужными аргументами. Проверите запуск сервера отдельным процессом и обмен через stdio.

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

• 🧪 Писать тесты и разбирать неисправности. Добавите pytest-проверки для обоих серверов: обнаружение инструментов, правильные расчёты и ожидаемые отказы. Отдельно проверите взаимодействие через stdio, а в финале восстановите неисправный вызов и повторите тесты.

🔥 Чем отличается курс

Вся практика строится вокруг двух понятных задач. Сервер заказов вы будете разрабатывать последовательно по объяснениям и примерам. Сервер доставки придётся реализовать самостоятельно: использовать знакомый способ регистрации инструментов, но написать собственную логику расчётов, клиента и тесты.

Вы проверите работу инструментов двумя способами. Сначала тесты обращаются к MCP-серверу через клиент SDK. Затем отдельная проверка запускает оба сервера как самостоятельные процессы и связывается с ними через stdio. Так вы увидите, работает ли взаимодействие за пределами прямого вызова Python-функции.

Ошибочные запросы входят в обычную практику: неизвестный заказ, неверная зона, неподходящий тип аргумента или недопустимый вес должны давать ожидаемый результат ошибки. Тесты будут проверять ответы MCP-клиента и конкретные значения, в том числе стоимость заказа и доставки.

Курс бесплатный: 5 модулей, 21 урок, видеолекции, текстовые объяснения и самостоятельные задания. Для практики достаточно Python 3.12 и Git. Все серверы работают локально, без Docker, платных языковых моделей и API-ключей. Результаты заданий вы проверяете по условиям и тестам, без ручной рецензии.

🎯 Итоговый проект

В собственном GitHub-репозитории у вас будут два MCP-сервера — заказов и доставки, по два инструмента в каждом, Python-клиенты и автоматические тесты.

В финальном задании новый сценарий обращения к серверу доставки выдаст неверную стоимость. Вы воспроизведёте ошибку, проверите входные данные и ответы инструментов, определите причину и исправите её. После этого оба контрольных расчёта должны пройти, а тесты pytest и отдельная проверка stdio — подтвердить, что серверы продолжают работать.

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

🧪 Поддержка

🧪 Самопроверка вместо ожидания ручной рецензии. Вы сверяете результат по критериям задания, ответам и предусмотренным в курсе локальным проверкам. Разборы самостоятельных упражнений доступны там, где они предусмотрены программой.

Индивидуальная проверка работ преподавателем и персональные консультации в этом курсе не предусмотрены. Формат рассчитан на самостоятельное прохождение.

🚀 О XNova

XNova — практические курсы и учебные проекты для разработчиков, тестировщиков и инженеров. Мы разбираем технологии на работающих примерах: с кодом, наблюдаемым результатом и объяснением инженерных решений.

🔗 xnova.dev — другие курсы и материалы XNova.

📬 Контакты и сообщество

Продолжить знакомство с XNova, следить за новыми материалами или задать организационный вопрос можно здесь:

• 📣 Telegram-канал: @xnova_dev — анонсы курсов, статьи и новости проекта.
• 💬 Написать XNova: @xnova_contact — контакт для вопросов о курсах и проекте.
• ✉️ Почта: contact@xnova.dev — если удобнее написать письмом.
• 💻 GitHub: xnova-tech — открытые учебные проекты и примеры.