KDnuggets показал, как поднять stateless MCP-сервер на Python с доступом по HTTP

KDnuggets 9 октября 2026 года выпустил пошаговый гайд «Build Your First MCP Server in Python (Stateless Spec Edition)». В нём показано, как написать MCP-сервер на Python и открыть по HTTP все три примитива Model Context Protocol: инструменты (tools), ресурсы (resources) и промпты (prompts). Ключевой акцент в слове stateless: сервер не хранит сессию между обращениями. Анонс короткий, и все детали редакции спецификации придётся сверять с официальной документацией. Но направление понятно: протокол, на котором строят подключение агентов к внешним системам, становится проще в эксплуатации.

Почему состояние — главная боль

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

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

Что внутри гайда

Материал рассчитан на тех, кто делает первый MCP-сервер. Из заявленного в анонсе:

• Язык: Python
• Транспорт: HTTP
• Примитивы: 3 (tools, resources, prompts)
• Режим: stateless, без сессий между запросами
• Источник и дата: KDnuggets, 9 октября 2026

Роли примитивов различаются, и путать их при проектировании дорого. Tools — функции, которые модель вызывает сама: поиск, запрос к API, запись в базу. Resources — данные, адресуемые по URI: файлы, документы, строки таблиц. Prompts — заготовленные шаблоны инструкций, которые обычно выбирает пользователь или клиентское приложение.

Показательно, что гайд выбирает HTTP, а не локальный процесс. Такой сервер доступен нескольким клиентам и командам, его можно закрыть аутентификацией и мониторить как любой другой сетевой сервис.

Как использовать это на практике

Начинать лучше с малого. Сделайте один инструмент с чёткой сигнатурой и описанием: модель выбирает функции именно по описанию, и расплывчатый текст превращается в неверные вызовы. Затем добавьте один ресурс и один промпт, чтобы увидеть все три примитива в работе. Проверяйте сервер отладчиком вроде MCP Inspector до подключения к реальному агенту.

Перед выкладкой в продакшен стоит проверить три вещи. Первое: версию спецификации и версию SDK. «Stateless-редакция» означает, что часть старых примеров может вести себя иначе. Второе: где хранится всё, что раньше жило в сессии. Корзины, токены и промежуточные результаты нужно вынести в Redis или базу. Третье: аутентификацию и ограничение прав инструментов. Сервер, который может писать в базу, не должен быть открыт всему интернету.

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