Мастерская MCPСоздать и проверить свой сервер

Мастерская MCP

Что хотите сделать?

Начните с первого сервера или переходите к практикам HTTP API.

Первый сервер: шесть шагов

Пройдите маршрут по порядку

  1. Первый MCP-сервер на Python: от пустой папки до ответа инструмента

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

    ≈ 35 мин

  2. Контракт MCP: проверьте схему и ответ своего инструмента

    Узнайте, какую схему инструмента получает MCP-клиент, и сравните её с ответом сервера. Инспектор проверяет сохранение внутренних пробелов и отказ при вызове неизвестного инструмента.

    ≈ 20 мин

  3. Валидация инструмента: добавьте предел и проверьте четыре отказа

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

    ≈ 25 мин

  4. Ресурсы и prompts: передайте правила и получите готовое сообщение

    Добавьте ресурс с правилами подписи и шаблон сообщения с этими правилами. Прочитайте ресурс и получите готовое сообщение через MCP без вызова модели.

    ≈ 25 мин

  5. Жизненный цикл stdio: конфигурация клиента и выбор транспорта

    Проверьте локальное подключение через stdio и найдите ошибки в конфигурации клиента. Разберите, какие свойства удалённого HTTP-сервера эта проверка не подтверждает.

    ≈ 20 мин

  6. Один запуск проверки лаборатории: успехи, отказы и завершение процессов

    Соберите пять проверок лаборатории в последовательный запуск с остановкой при ошибке. Сравните тесты функции и обмена MCP и убедитесь, что неверное ожидание вызывает падение.

    ≈ 30 мин

Сервер уже работает

Примените MCP к HTTP API

  1. Практика 1 из 2

    Свой MCP tool поверх HTTP API: клиент, схема и один безопасный запрос

    Соберите MCP-инструмент для чтения одной записи об оборудовании. Отделите HTTP-клиент от схемы инструмента и проверьте результат на синтетических ответах без сети.

    Перед началом: Python 3.11, первый рабочий MCP tool и понимание входной схемы. Начните с уроков о первом сервере и валидации.

  2. Практика 2 из 2

    Проверьте HTTP-адаптер: семь тестов отказов, таймаут и секрет в ответе

    Проверьте HTTP-адаптер на неверном входе, ошибках ответа и таймауте. Семь тестов проверяют его контракт и отсутствие синтетического секрета в публичной ошибке.

    Перед началом: Файлы http_api_client.py и http_api_tool.py из практики HTTP API, Python 3.11 и те же закреплённые зависимости.

Вопросы перед началом

Нужно ли проходить все материалы подряд?

Первые шесть шагов образуют одну лабораторию: следующие уроки используют файлы предыдущих. Разбор normalize_currency — отдельный пример. К практикам HTTP API переходите, когда уже понятны первый инструмент и его входная схема.