当前位置：首页 > news >正文

MCP Streamable HTTP 传输层的深度解析及实战分析

news 来源：原创 2025/7/28 7:12:30

在这里插入图片描述

一、Streamable HTTP 传输层设计革新

1. 核心设计思想

协议融合：将 HTTP/1.1、HTTP/2 与 SSE 协议特性深度整合
动态协商：通过 HTTP Header 实现传输协议动态协商（X-MCP-Transport）
流式优先：默认启用流式传输，支持半双工通信
背压控制：基于 HTTP/2 流级流量控制实现智能速率调节

2. 与传统 HTTP+SSE 的对比

特性	传统 HTTP+SSE	Streamable HTTP
协议栈	单一 HTTP/1.1	HTTP/1.1/2 智能切换
流式支持	依赖特定 Content-Type	内置流式传输层
多路复用	不支持	HTTP/2 多路复用
背压控制	无	流级流量控制
协议协商	静态配置	动态 Header 协商

3. 协议栈架构

+----------------+     +-------------------+     +------------------+
|  Application    |     |   Streamable      |     |    HTTP/2        |
|  Layer (MCP)    |<----|  HTTP Transport   |<----|   Multiplexing   |
|                 |     |   Layer           |     | (可选)          |
+----------------+     +-------------------+     +------------------+|                      |                      ||  JSON Events         |  Binary Frames       |v                      v                      v
+----------------+     +-------------------+     +------------------+
|   TLS 1.3      |     |   HTTP/1.1        |     |   QUIC           |
+----------------+     +-------------------+     +------------------+

在这里插入图片描述

二、Spring AI Alibaba Streamable HTTP 实现

1. 核心组件架构

2. 关键代码实现

(1) 请求处理适配器

public class StreamableRequestAdapter {private final TransportMode transportMode;private final Decoder decoder;private final Encoder encoder;public StreamableRequestAdapter(MCPRequest request) {this.transportMode = determineTransportMode(request);this.decoder = createDecoder(transportMode);this.encoder = createEncoder(transportMode);}private TransportMode determineTransportMode(MCPRequest request) {if (request.getHeader("X-MCP-Transport").equals("binary")) {return TransportMode.HTTP2;}return request.getBodySize() > 1024 * 1024 ? TransportMode.SSE : TransportMode.JSON;}
}

(2) 流式响应处理器

@RestController
@RequestMapping("/mcp/v1")
public class MCPController {@PostMapping("/execute")public void executeCommand(@RequestBody MCPRequest request,HttpServletResponse response) {// 流式传输检测boolean isStreamable = request.getHeader("Accept-Stream").contains("text/event-stream");StreamableResponseWriter writer = new StreamableResponseWriter(response);writer.setContentType(isStreamable ? "text/event-stream" : "application/json");// 执行流式处理try (StreamableContext ctx = new StreamableContext(request, writer)) {executeTool(ctx);}}private void executeTool(StreamableContext ctx) {// 模拟流式响应for (int i = 0; i < 5; i++) {ctx.writeEvent(new MCPEvent().setStreamId(UUID.randomUUID().toString()).setChunk("Processing chunk " + i));}ctx.complete();}
}

3. Spring Boot 配置

spring:ai:mcp:transport:mode: AUTOhttp2:enabled: truemax-concurrent-streams: 512sse:chunk-size: 1024reconnect-interval: 5000security:enabled: truetoken: ${MCP_TOKEN:default-secret}

三、Higress 集成方案

1. 核心网关配置

http {stream {server {listen 8080;proxy_pass backend_servers;proxy_protocol on;proxy_http_version 2;}}server {listen 8081 http2;location /mcp/v1 {proxy_pass http://mcp-service;proxy_set_header X-MCP-Transport $http_x_mcp_transport;proxy_http_version 2;# 流式传输优化proxy_request_buffering off;proxy_buffering off;proxy_chunked_transfer_encoding on;# 安全策略proxy_set_header Authorization $http_authorization;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;}}
}

2. WASM 智能路由模块

// higress-plugin.js
module.exports = {name: 'mcp-stream-optimizer',version: '1.0.0',async requestReceived(context) {const request = context.getRequest();const headers = request.getHeaders();// 流式传输检测逻辑if (headers['x-mcp-stream'] === 'required' && headers['content-type'] === 'application/octet-stream') {// 强制启用 HTTP/2context.setTransportProtocol('h2');context.setResponseHeader('X-MCP-Transport', 'binary');}}
};

MCP Streamable HTTP 传输层的深度解析及实战分析

一、Streamable HTTP 传输层设计革新 1. 核心设计思想协议融合：将 HTTP/1.1、HTTP/2 与 SSE 协议特性深度整合动态协商：通过 HTTP Header 实现传输协议动态协商（X-MCP-Transport）流式优先：默认启用流式传输，支持半双工通信背压控制：基于 HTTP/2 流级流量控制实现智能速…...

编程日记 2025/7/28 7:12:30

六大设计模式--OCP（开闭原则）：构建可扩展软件的基石

写在前面：一个真实的项目悲剧某电商平台促销功能每次迭代都需要修改核心订单类，导致： ✅ 双十一活动修改导致支付功能崩溃 ✅ 新人优惠引发会员系统连环故障 ✅ 每次发布需全量回归测试根本原因：系统架构违反开闭原则一、开闭…...

编程日记 2025/7/28 6:46:32

ActiveMQ 生产环境问题排查与调优指南（一）

一、引言在当今复杂的分布式系统架构中，消息中间件扮演着至关重要的角色，而 ActiveMQ 作为一款广泛使用的开源消息中间件，凭借其丰富的特性、良好的稳定性和易用性，在众多企业的生产环境中占据了一席之地。它基于 JMS&#xff08…...

编程日记 2025/7/28 6:42:27

深入理解 JavaScript 中的 FileReader API：从理论到实践

文章目录深入理解 JavaScript 中的 FileReader API：从理论到实践前言什么是 FileReader？核心特性 FileReader 的常用方法事件监听实际案例案例 1：读取文本文件内容案例 2：图片预览（Data URL）案例 3&#x…...

编程日记 2025/7/22 20:40:44

Google LLM prompt engineering(谷歌提示词工程指南)

文章目录基本概念AI输出配置：调整AI的回答方式输出长度温度（Temperature）Top-K和Top-P 提示技术：让AI更好地理解你零样本提示（Zero-shot）少样本提示（Few-shot）系统提示（…...

编程日记 2025/7/28 7:08:00

前端npm包发布流程：从准备到上线的完整指南

无论是使用第三方库还是创建和分享自己的工具，npm都为我们提供了一个强大而便捷的平台，然而很多开发者在将自己的代码发布到npm上时往往面临各种困惑和挑战，本篇文章将从准备工作到发布上线，探讨如何让npm包更易发布及避免常见的坑…...

编程日记 2025/7/28 1:08:18

【MySQL】表空间结构 - 从何为表空间到段页详解

📢博客主页：https://blog.csdn.net/2301_779549673 📢博客仓库：https://gitee.com/JohnKingW/linux_test/tree/master/lesson 📢欢迎点赞 👍 收藏 ⭐留言 📝 如有错误敬请指正！ &…...

编程日记 2025/7/27 19:43:14

OB Cloud 云数据库V4.3：SQL +AI全新体验

OB Cloud 云数据库V4.3：SQL AI全新体验简介 OB Cloud云数据库全新升级至V4.3版本，为用户带来了SQLAI的最新技术体验，强化数据库的传统功能，深度融合了人工智能技术，引入先进的向量检索功能和优化的SQL引擎&#xff0c…...

编程日记 2025/7/28 3:37:26

【Linux系统】第四节—详解yum+vim

hello 我是云边有个稻草人 Linux—本节课所属专栏—欢迎订阅—持续更新中~ 目录画板—本节课知识点详解一、软件包管理器 1.1 什么是软件包 1.2 Linux软件⽣态 1.3 yum具体操作【查看软件包】【安装软件】【卸载软件】【注意事项】 1.4 安装源二、vim 2.1 …...

编程日记 2025/7/27 4:47:02

Git的核心作用详解

一、版本控制与历史追溯 Git作为分布式版本控制系统，其核心作用是记录代码的每一次修改，形成完整的历史记录。通过快照机制，Git会保存每次提交时所有文件的完整状态（而非仅记录差异），确保开发者可以随时回…...

编程日记 2025/7/27 16:40:52

Three.js + React 实战系列 - 职业经历区实现解析 Experience 组件✨（互动动作 + 3D 角色 + 点击切换动画）

对个人主页设计和实现感兴趣的朋友可以订阅我的专栏哦！！谢谢大家！！！ 在这篇博客中，我们将分析一个极其有趣和互动性的组件 - Experience.jsx，该组件用于在主页中呈现个人的工作经历。这个组件…...

编程日记 2025/7/24 17:29:51

3D虚拟工厂vue3+three.js

1、在线体验 3D虚拟工厂在线体验 2、功能介绍 1. 全屏显示功能2. 镜头重置功能3. 企业概况信息模块4. 标签隐藏/显示功能5. 模型自动旋转功能6. 办公楼分层分解展示7. 白天/夜晚切换8. 场景资源预加载功能9. 晴天/雨天/雾天10. 无人机视角模式11. 行人漫游视角模式12. 键盘…...

编程日记 2025/7/28 7:10:52

[Java实战]Spring Boot 解决跨域问题（十四）

[Java实战]Spring Boot 解决跨域问题（十四） 一、CORS 问题背景什么是跨域问题？ 当浏览器通过 JavaScript 发起跨域请求（不同协议、域名、端口）时，会触发同源策略限制，导致请求被拦截。示例场…...

编程日记 2025/7/28 6:53:15

嵌入式硬件篇---CAN

文章目录前言1. CAN协议基础1.1 物理层特性差分信号线终端电阻通信速率总线拓扑 1.2 帧类型1.3 数据帧格式 2. STM32F103RCT6的CAN硬件配置2.1 硬件连接2.2 CubeMX配置启用CAN1模式波特率引脚分配过滤器配置（可选） 3. HAL库代码实现3.1 CAN初始化3.2 发…...

编程日记 2025/7/24 22:53:16

（2025）图文解锁RAG从原理到代码实操，代码保证可运行

什么是RAG RAG(检索增强生成)是一种将语言模型与可搜索知识库结合的方法，主要包含以下关键步骤： 数据预处理加载：从不同格式(PDF、Markdown等)中提取文本分块：将长文本分割成短序列(通常100-500个标记)，作为检索单元…...

编程日记 2025/7/27 7:29:10

TWAS、GWAS、FUSION

全基因组关联研究（GWAS，Genome-Wide Association Study）是一种统计学方法，用于在全基因组水平上识别与特定性状或疾病相关的遗传变异。虽然GWAS可以识别与性状相关的遗传信号，但它并不直接揭示这些遗传变异如何影响生物…...

编程日记 2025/7/27 4:30:18

大模型微调终极方案：LoRA、QLoRA原理详解与LLaMA-Factory、Xtuner实战对比

文章目录一、微调概述1.1 微调步骤1.2 微调场景二、微调方法2.1 三种方法2.2 方法对比2.3 关键结论三、微调技术3.1 微调依据3.2 LoRA3.2.1 原理3.2.2 示例 3.3 QLoRA3.4 适用场景四、微调框架4.1 LLaMA-Factory4.2 Xtuner4.3 对比一、微调概述微调（Fine-tun…...

编程日记 2025/7/28 7:06:07

FHE 之面向小白的引导（Bootstrapping）

1. 引言 FHE初学者和工程师常会讨论的一个问题是； “什么是引导（bootstrapping）？” 从理论角度看，这个问题的答案很简单： 引导就是套用 Gentry 提出的思想——在加密状态下同态地执行解密操作&#xff…...

编程日记 2025/7/28 6:54:10

安装:Kali2025+Docker

安装:Kali2025Docker Kali2025安装直接官网下载WMware版本 https://www.kali.org/get-kali/#kali-virtual-machines 直接打开运行初始用户密码 kali/kali sudo -i 命令切换到root 更换镜像切换到其他可用的 Kali Linux 镜像源可能会解决问题,可以使用国内的镜像源&…...

编程日记 2025/7/26 16:49:40

什么是深拷贝什么是浅拷贝，两者区别

什么是深拷贝什么是浅拷贝，两者区别 1.深拷贝递归复制对象的所有层级，嵌套的引用类型属性，最后生成一个完全独立的新对象，与原对象无任何引用关联。特点： 新对象和原对象的所有层级属性是独立的（修改…...

编程日记 2025/7/24 10:35:03

A2A大模型协议及Java示例

A2A大模型协议概述 1. 协议作用 A2A协议旨在解决以下问题： 数据交换：不同应用程序之间的数据格式可能不一致，A2A协议通过定义统一的接口和数据格式解决这一问题。模型调用：提供标准化的接口，使得外部应用可以轻松调…...

编程日记 2025/7/28 2:28:29

第七章数据库编程

1 数据库编程基础 1.1 数据库系统概述数据库系统是由数据库、数据库管理系统(DBMS)和应用程序组成的完整系统。其主要目的是高效地存储、管理和检索数据。现代数据库系统通常分为以下几类： 关系型数据库(RDBMS)：如MySQL、PostgreSQL、Oracle等&#x…...

编程日记 2025/7/26 23:00:25

电影感户外哑光人像自拍摄影Lr调色预设，手机滤镜PS+Lightroom预设下载！

调色详情电影感户外哑光人像自拍摄影 Lr 调色，是借助 Lightroom 软件，针对户外环境下拍摄的人像自拍进行后期处理。旨在模拟电影画面的氛围与质感，通过调色赋予照片独特的艺术气息。强调打造哑光效果，使画面色彩不过于浓烈刺眼&a…...

编程日记 2025/7/26 18:09:36

C++--类的构造函数与初始化列表差异

一，引言在类中成员函数的构造函数担任其将对象初始化的作用，而初始化列表也有着相似的作用。大部分人建议都是初始化列表进行初始化，本文主要进行讲解二者的区别。首先看一下构造函数的初始化方式： #define _CRT_SECURE_NO…...

编程日记 2025/7/25 23:43:59

深入浅出之STL源码分析4_类模版

1.引言我在上面的文章中讲解了vector的基本操作，然后提出了几个问题。 STL之vector基本操作-CSDN博客 1.刚才我提到了我的编译器版本是g 11.4.0，而我们要讲解的是STL（标准模板库），那么二者之间的关系是什么&#x…...

编程日记 2025/7/22 20:01:07

Lambda表达式解读

本文通过具体案例演示函数式接口Function<T,R>的三种实现方式演变过程。一、传统匿名内部类实现 Integer resInt1 t1(new Function<String, Integer>() {Overridepublic Integer apply(String s) {int i Integer.parseInt(s);return i;} });实现特点&#xff1…...

编程日记 2025/7/24 15:34:43

PySide6 GUI 学习笔记——常用类及控件使用方法（常用类边距QMarginsF）

文章目录类简介方法总览关键说明示例代码类简介 QMarginsF 用于定义四个浮点型边距（左、上、右、下），描述围绕矩形的边框尺寸。所有边距接近零时 isNull() 返回 True，支持运算符重载和数学运算。方法总览方法名/运算符参数返…...

编程日记 2025/7/27 18:40:11

Android方法耗时监控插件开发

需求：自定义一个Gradle插件，这个Gradle插件可以统计方法的耗时，并当方法耗时超过阈值时，可以通过打印Log日志在控制台，然后可以通过Log定位到耗时方法的位置，帮助我们找出耗时方法和当前线程名，…...

编程日记 2025/7/24 21:53:12

TWAS / FUSION

FUSION 是一套用于执行转录组范围和调控组范围关联研究（TWAS 和 RWAS）的工具。它通过构建功能/分子表型的遗传成分的预测模型，并使用 GWAS 汇总统计数据预测和测试该成分与疾病的关联，目标是识别 GWAS 表型与仅在参考数据中测量的…...

编程日记 2025/7/26 1:19:47

C++中的static_cast：类型转换的安全卫士

C中的static_cast：类型转换的安全卫士在C编程中，类型转换是不可避免的操作，而static_cast作为C四大强制类型转换运算符之一，是最常用且相对安全的一种转换方式。今天我们就来深入探讨一下这个重要的类型转换工具。一、static_…...

编程日记 2025/7/26 19:41:08

uniapp-商城-51-后台商家信息（logo处理）

前面对页面基本进行了梳理和说明，特别是对验证规则进行了阐述，并对自定义规则的兼容性进行了特别补充，应该说是干货满满。不知道有没有小伙伴已经消化了。下面我们继续前进，说说页面上的logo上传组件，主要就是uni-fil…...

编程日记 2025/7/24 1:03:14

04 mysql 修改端口和重置root密码

当我们过了一段时间，忘了自己当初创建的数据库密码和端口，或者端口被占用了，要怎么处理呢首先，我们先停止mysql。一、修改端口打开my.ini文件，搜索port，默认是3306，根据你的需要修改为其他…...

编程日记 2025/7/26 1:28:51

多线程 2 - 死锁问题

死锁死锁，是多线程代码中的一类经典问题。加锁能够解决线程安全问题，但如果加锁方式不当，就很可能产生死锁。出现死锁的三种场景 1、一个线程一把锁就像上篇文章讲过的，如果对同一个线程上了两把锁，而且上的锁是…...

编程日记 2025/7/23 4:37:11

网络原理（Java）

注：此博文为本人学习过程中的笔记在网络初始中谈到TCP/IP五层模型，接下来我们将介绍这里面涉及到的网络协议。应用层是程序员接触最多的层次，程序员写的代码只要涉及到网络通信都可以视为是应用层的一部分。应用层里的东西和程序员直接相…...

编程日记 2025/7/26 10:38:08

HDFS 常用基础命令详解——快速上手分布式文件系统

简介： 本文面向刚接触 Hadoop HDFS（Hadoop 分布式文件系统）的读者，结合 CSDN 博客风格，系统梳理最常用的 HDFS 客户端命令，并配以示例和注意事项，帮助你在开发和运维中快速掌握 HDFS 的文件管理…...

编程日记 2025/7/27 17:59:54

Unity Shaders and Effets Cookbook

目录作者简介审稿人简介前言我是偏偏 Unity Shaders and Effets Cookbook 第一章：Diffuse Shading - 漫反射着色器第二章：Using Textures for Effects - 着色器纹理特效的应用第三章：Making Your Game Shine with Specular - 镜…...

编程日记 2025/7/22 17:14:44

Markdown—LaTeX 数学公式

目录一、字母1. 希腊大写字母2. 希腊小写字母3. 花体字母二、上标和下标1. 上标2. 下标3. 其他三、括号四、数学符号1. 基本数学符号1）运算符2）常见函数3）分式、根号、累加/乘4）极限5）积分 2. 三角函数与几何符号1&…...

编程日记 2025/7/25 4:19:06

AI 驱动的开发工具

🔧 主流 AI 前端开发工具 1. GitHub Copilot 由 GitHub 与 OpenAI 联合开发，集成在 Visual Studio Code、JetBrains 等主流 IDE 中，提供智能代码补全、函数生成等功能，极大地提高了开发效率。 (CSDN博客) 2. Cursor 一款 AI 驱…...

编程日记 2025/7/24 18:15:08

【入门】数字走向I

描述输入整数N，输出相应方阵。输入描述一个整数N。（ 0 < n < 10 ) 输出描述一个方阵，每个数字的场宽为3。 #include <bits/stdc.h> using namespace std; int main() {int n;cin>>n;for(int i1;i<n*n;i){cout…...

编程日记 2025/7/24 6:35:08

Kubernetes生产实战(十三)：灰度发布与蓝绿发布实战指南

在微服务架构中，如何安全高效地发布新版本是每个团队必须掌握的技能。本文将深入讲解Kubernetes中两种主流发布策略的落地实践，附带生产环境真实案例。一、金丝雀发布（灰度发布）：渐进式验证新版本核心思想&#xf…...

编程日记 2025/7/25 7:42:34

数孪实战笔记（1）数字孪生的含义、应用及技术体系

一、含义数字孪生（Digital Twin）是一种通过数字化模型在虚拟世界中实时映射和模拟物理实体、系统或过程的技术。它的核心目的是通过对现实对象的建模、感知、分析和预测，实现对物理世界的全面感知、智能控制和优化决策。数字孪生实体对象 …...

编程日记 2025/7/22 2:11:28

深入浅出之STL源码分析5_类模版实例化与特化

在 C 中，类模板的实例化（Instantiation）和特化（Specialization） 是模板编程的核心概念，而显式实例化（Explicit Instantiation）和隐式实例化（Implicit Insta…...

编程日记 2025/7/26 0:51:00

JDBC演进之路：从基础操作到高效连接池

文章目录一、JDBC 1.0：手动管理的起点1.1 核心特点1.2 代码示例：1.3 痛点分析二、JDBC 2.0：配置化的升级2.1 核心改进2.2 代码示例2.3 优势与不足三、JDBC 3.0：连接池的革命3.1 核心改进3.2 代码示例3.3 核心优势四、版本对比…...

编程日记 2025/7/20 23:48:39

远程调试---在电脑上devtools调试运行在手机上的应用

1、启动项目–以vite项目为例:先ipconfig查看ip地址 ,然后在vite中配置host为ip地址 2、手机上查看项目:保证手机和电脑在同一局域网, 在手机浏览器打开我们vite启动的项目地址, 3、使用chii进行远程调试 (1) 安装 npm install chii -g (2)启动 chii start -p 8080 (3)在…...

编程日记 2025/7/26 21:46:31

街景主观感知全流程（自建数据集+两两对比程序+Trueskill计算评分代码+训练模型+大规模预测）27

目录 0、Emeditor软件1、Place Pluse 2.0数据集2、街景主观感知大框架2.1 街景主观感知：自建数据集2.2 街景主观感知：两两对比程序2.3 街景主观感知：Trueskill评分2.4 街景主观感知：训练模型，Resnet或EfficientNet或V…...

编程日记 2025/7/23 5:43:30

进阶二：基于HC-SR04和LCD1602的超声波测距

一、实验目的掌握HC-SR04超声波测距模块的工作原理和使用方法。学会使用LCD1602液晶显示屏显示测量数据。熟悉89C51单片机与外设的接口电路设计和编程方法。二、实验原理 1. HC-SR04超声波测距模块原理 HC-SR04超声波测距模块可提供2cm - 400cm的非接触式距离感测功能，测距精…...

编程日记 2025/7/24 22:21:59

单因子实验方差分析

本文是实验设计与分析（第6版，Montgomery著傅珏生译)第3章单因子实验方差分析python解决方案。本文尽量避免重复书中的理论，着于提供python解决方案，并与原书的运算结果进行对比。您可以从下载实验设计与分析（第6版&a…...

编程日记 2025/7/22 23:54:34

《Python星球日记》第53天：卷积神经网络（CNN）入门

名人说：路漫漫其修远兮，吾将上下而求索。—— 屈原《离骚》创作者：Code_流苏(CSDN)（一个喜欢古诗词和编程的Coder😊） 目录一、图像表示与通道概念1. 数字图像的本质2. RGB颜色模型3. 图像预处理二、卷积…...

编程日记 2025/7/26 5:30:56

基于人工智能的个性化 MySQL 学习路径推荐研究

基于人工智能的个性化 MySQL 学习路径推荐研究摘要：随着信息技术的飞速发展，数据库在各行业应用广泛，MySQL 作为主流数据库之一，学习需求庞大。然而，不同学习者在知识水平、学习进度和目标上存在差异，传统统一的学习路径难以满足个性化需求。本研究通过运用人工智能技…...

编程日记 2025/7/26 1:28:58

阿里云OSS-服务端加签直传说明/示例（SpringBoot）

目录概述 OSS文件上传方式 1. OSS控制台上传 2. 客户端直传 3. 后端上传 4. 加签直传服务端加签方式 1. 服务端生成PostObject所需的签名和Post Policy 2.服务端生成STS临时访问凭证 3. 服务端生成PutObject所需的签名URL 实现1：生成PostObject所需的签…...

编程日记 2025/7/24 14:44:22