Потоковый транспорт HTTP

Современный удалённый транспорт MCP называется Streamable HTTP. Он позволяет разместить сервер по одному веб-URL, доступному любому клиенту в интернете.

В отличие от более старых решений, Streamable HTTP использует одну конечную точку, часто такую как /mcp. И запросы, и ответы проходят через этот единственный путь.

Чтобы вызвать инструмент, клиент отправляет обычный HTTP-запрос POST к конечной точке. В теле находится то же сообщение JSON-RPC, о котором вы уже узнали. 📨

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

Заголовок Accept клиента сообщает, что он умеет обрабатывать. Если указать и JSON, и тип потока событий, сервер сможет выбрать лучший формат ответа.

Изменился транспорт, но не язык. Каждое сообщение по HTTP — это тот же запрос, ответ или уведомление JSON-RPC, с которым Вы уже познакомились.

В Python SDK достаточно переключить один параметр: запустить сервер с транспортом streamable-http вместо stdio. Инструменты останутся совершенно теми же.

Поскольку это обычный HTTP, он хорошо работает со всем стеком веб-технологий: балансировщики нагрузки, прокси и TLS работают без каких-либо особых настроек. 🌐

Streamable HTTP может работать с сохранением состояния, запоминая сеанс, или без состояния, обрабатывая каждый вызов заново. Вы выбираете вариант в зависимости от того, как сервер хранит контекст.

В более раннем варианте HTTP+SSE использовались два отдельных пути, и он был менее удобным. Streamable HTTP заменил его как рекомендуемый способ удалённого предоставления MCP.

Именно конструкция с одной конечной точкой делает удалённый сервер MCP практичным для развёртывания и позволяет любому клиенту легко к нему подключаться откуда угодно.

Streamable HTTP предоставляет MCP через одну конечную точку HTTP: клиенты отправляют JSON-RPC методом POST, а сервер отвечает JSON или потоком событий в реальном времени. Та же логика — удалённый доступ. 🚀