第三章 Streamable HTTP协议会话与连接管理

本文档系统化地介绍了Streamable HTTP协议的会话管理架构，采用分层设计分为客户端、服务端和共享模块。客户端通过StreamableHTTPTransport维护会话ID并自动注入请求头，服务端通过StreamableHTTPServerTransport验证会话和终止连接，共享模块BaseSession提供基础功能。系统基于HTTP头信息（MCP_SESSION_ID_HEADER）管

sfdzhmr

403人浏览 · 2025-10-28 08:39:58

sfdzhmr · 2025-10-28 08:39:58 发布

简介

本文档系统化地记录了Streamable HTTP协议的会话与连接管理功能。详细说明了MCP_SESSION_ID_HEADER在会话标识中的作用，以及服务端如何通过该头信息进行会话验证和路由。解析了DELETE请求用于显式会话终止的实现机制，包括404状态码在会话过期后的应用。阐述了客户端StreamableHTTPTransport如何维护和更新会话ID，并在后续请求中自动注入。通过交互时序图展示了完整的会话生命周期：从初始化请求建立会话，到GET/POST请求维持连接，最终通过DELETE请求终止会话。提供了会话管理的最佳实践，包括会话超时处理和错误恢复策略。

项目结构

本项目采用分层架构设计，主要分为客户端、服务端和共享模块三个部分。客户端模块位于src\mcp\client目录下，包含streamable_http.py等文件，负责实现客户端的会话管理功能。服务端模块位于src\mcp\server目录下，包含streamable_http.py等文件，负责处理会话验证、路由和终止等操作。共享模块位于src\mcp\shared目录下，包含session.py等文件，提供跨客户端和服务端的会话管理基础功能。示例服务器位于examples\servers\simple-streamablehttp目录下，用于演示会话管理的实际应用。

图示来源

章节来源

核心组件

系统的核心组件包括客户端的StreamableHTTPTransport、服务端的StreamableHTTPServerTransport和共享的BaseSession。StreamableHTTPTransport负责客户端的会话管理，包括会话ID的维护和在请求中自动注入。StreamableHTTPServerTransport负责服务端的会话验证、路由和终止，通过MCP_SESSION_ID_HEADER进行会话标识。BaseSession提供跨客户端和服务端的会话管理基础功能，包括请求/响应链接、通知和进度跟踪。

章节来源

架构概述

系统采用客户端-服务端架构，通过HTTP协议进行通信。客户端使用StreamableHTTPTransport管理会话，服务端使用StreamableHTTPServerTransport处理会话相关操作。会话管理基于HTTP头信息，特别是MCP_SESSION_ID_HEADER和MCP_PROTOCOL_VERSION_HEADER。会话生命周期包括初始化、维持和终止三个阶段，通过POST、GET和DELETE请求分别实现。

图示来源

详细组件分析

客户端会话管理分析

客户端通过StreamableHTTPTransport类管理会话。该类维护一个会话ID，并在每次请求中自动注入MCP_SESSION_ID_HEADER头信息。会话ID在初始化请求的响应中获取，并在后续请求中使用。

客户端会话管理类图

图示来源

streamable_http.py

服务端会话管理分析

服务端通过StreamableHTTPServerTransport类管理会话。该类负责验证会话ID、处理会话终止请求，并在会话过期后返回404状态码。

服务端会话管理类图

图示来源

streamable_http.py

会话生命周期时序图

图示来源

章节来源

依赖分析

系统的主要依赖关系如下：客户端的StreamableHTTPTransport依赖于共享的BaseSession进行会话管理；服务端的StreamableHTTPServerTransport也依赖于BaseSession；客户端和服务端都依赖于HTTPX库进行HTTP通信。测试代码依赖于requests库进行集成测试。