1. 为什么我要把 MCP Server 从 SSE 迁到 Streamable HTTP如果你最近在 VS Code 里折腾 AI 工具链大概率已经踩过 SSE 的坑MCP Client 和 MCP Server 一旦握手Server 就得在整个连接生命周期里死死抱住这条长连接。本地跑跑还行一旦把 MCP Server 放到远端高并发下连接数直接爆炸负载均衡、超时重连、心跳保活全得自己扛。SSE 不是不能用而是它把「有状态」这件事写死在了协议层开发者没有选择权。Streamable HTTP 的出现改变了这个局面。它把「是否保持状态」的决定权交还给 Server你可以做 Stateless每个请求独立处理水平扩容毫无压力也可以做 Stateful按需维持会话。对写 Node.js 的开发者来说这意味着一个 MCP Server 骨架可以同时适配本地调试和远端部署不用再为 SSE 的长连接做额外架构设计。这篇文章面向在 VS Code 中调试 AI 工具的开发者目标很明确给你一份可复制的 Node.js Streamable HTTP MCP Server 骨架配上mcp.json和config.toml配置片段再通过 TaoToken 的统一 Key/API 通道完成一次真实请求验证。跟着做你能在本地把整条链路跑通而不是停留在「知道有这么个协议」的层面。我试过用旧的 SSE 模板改结果发现连接管理逻辑和 Streamable HTTP 的请求模型对不上索性按新协议重写了一遍。下面把踩过的坑和最终能跑的配置都摊开讲。2. TaoToken 前置统一 Key 与 API 通道准备在写代码之前先把「模型从哪来」这件事定下来。MCP Server 本身只是工具调用的桥梁真正干活的是背后的模型。TaoToken 在这里的角色是提供一个统一的 Key 和 API 通道让你在 VS Code 里调试时不用为每个模型单独配一套凭证。你需要先拿到一个可用的 API Key。访问控制台创建https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建完成后在 API Keys 页面复制你的 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewriteAPI 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base URL 使用。如果你用的是 Anthropic 风格的客户端接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite提示Key 只创建一次就够后续 MCP Server、VS Code 配置、命令行验证都复用同一个 Key。不要把它硬编码进会提交到 Git 的文件里用环境变量或本地配置文件承载。这一步不需要装任何额外软件拿到 Key 和 base URL 就可以进入下一步。整个流程里TaoToken 承担的是「统一入口」的角色你的 MCP Server 通过它调用模型VS Code 通过它连接工具链两边共用一套凭证。3. 可复制配置Node.js Streamable HTTP MCP Server 骨架3.1 初始化项目与依赖先确认 Node.js 版本。Streamable HTTP 相关的 SDK 对 Node 版本有要求建议用 LTSnode -v # 期望输出 v20.x 或更高创建项目目录并初始化mkdir streamable-mcp-demo cd streamable-mcp-demo npm init -y npm install modelcontextprotocol/sdk express zod npm install -D typescript tsx types/node types/express这里用modelcontextprotocol/sdk作为 MCP 协议实现express承载 HTTP 层zod做参数校验。TypeScript 负责类型安全tsx用于开发期直接运行。3.2 核心 Server 代码新建src/server.ts这是整个骨架的核心。Streamable HTTP 的关键在于Server 通过一个 HTTP 端点接收 POST 请求根据请求内容决定是否维持会话。import express from express; import { McpServer } from modelcontextprotocol/sdk/server/mcp.js; import { StreamableHTTPServerTransport } from modelcontextprotocol/sdk/server/streamableHttp.js; import { z } from zod; const app express(); app.use(express.json()); // 创建 MCP Server 实例注册一个天气查询工具作为示例 function createServer() { const server new McpServer({ name: weather-mcp-server, version: 1.0.0, }); server.tool( get_weather, 根据城市名查询当前天气, { city: z.string().describe(城市名称例如 Beijing) }, async ({ city }) { // 实际项目中这里调用真实天气 API const mock { city, temperature: 22°C, condition: Sunny }; return { content: [{ type: text, text: JSON.stringify(mock) }], }; } ); return server; } // Streamable HTTP 端点无状态模式每个请求独立处理 app.post(/mcp, async (req, res) { const server createServer(); const transport new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, // 无状态模式 }); res.on(close, () { transport.close(); server.close(); }); await server.connect(transport); await transport.handleRequest(req, res, req.body); }); const PORT process.env.PORT || 3000; app.listen(PORT, () { console.log(Streamable HTTP MCP Server listening on http://localhost:${PORT}/mcp); });这段代码里有两个关键点。第一sessionIdGenerator: undefined表示无状态模式每个 POST 请求都会新建一个 Server 和 Transport 实例请求结束即释放。第二res.on(close)里做清理避免连接泄漏。如果你需要 Stateful 模式把sessionIdGenerator换成一个返回唯一 ID 的函数即可SDK 会自动管理会话映射。3.3 配置 VS Code 的 mcp.json在项目根目录创建.vscode/mcp.json让 VS Code 知道去哪里找你的 MCP Server{ servers: { weather-mcp-server-streamable-http: { type: http, url: http://localhost:3000/mcp } } }注意type字段填http这是 Streamable HTTP 在 VS Code 配置里的标识。旧的 SSE 配置用的是sse类型加一个/sse端点两者不通用。如果你同时保留旧配置建议把 SSE 那条注释掉避免 VS Code 在 Agent Mode 里选错。3.4 配置 config.toml可选用于命令行客户端如果你用支持 TOML 配置的客户端做命令行验证可以加一份config.toml[mcp_servers.weather] type http url http://localhost:3000/mcp这份配置和mcp.json表达的是同一件事只是格式不同。选你实际使用的客户端对应的那份即可。4. 验证请求一次跑通 Streamable HTTP 链路4.1 启动 Servernpx tsx src/server.ts看到Streamable HTTP MCP Server listening on http://localhost:3000/mcp就说明服务起来了。4.2 用 curl 验证协议层先不急着开 VS Code用 curl 直接打一发确认 Streamable HTTP 端点能正确响应 MCP 的 initialize 请求curl -X POST http://localhost:3000/mcp \ -H Content-Type: application/json \ -H Accept: application/json, text/event-stream \ -d { jsonrpc: 2.0, id: 1, method: initialize, params: { protocolVersion: 2025-03-26, capabilities: {}, clientInfo: { name: curl-test, version: 1.0.0 } } }期望返回一个 JSON-RPC 响应包含serverInfo和capabilities字段。如果返回 406 或 400多半是Accept头没带全——Streamable HTTP 要求客户端同时接受application/json和text/event-stream。4.3 在 VS Code 中连接 TaoToken 通道打开 VS Code建议用较新版本进入 Agent Mode。在 MCP 面板里应该能看到weather-mcp-server-streamable-http点击启动。然后在对话里让它调用天气工具帮我查一下 Beijing 的天气如果工具被正确调用并返回了模拟数据说明 MCP 链路通了。接下来把模型通道切到 TaoToken在 VS Code 的模型配置里把 API base URL 设为https://taotoken.net/api填入你之前创建的 Key。这样模型请求走 TaoToken 统一通道工具调用走本地 MCP Server两条链路各司其职。想先在网页端确认模型通道是否正常可以用模型对话页面发一条测试消息https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite4.4 成功结果长什么样一次完整的成功链路是这样的VS Code 发出工具调用请求 → 本地 MCP Server 通过 Streamable HTTP 接收 → 执行get_weather逻辑 → 返回 JSON-RPC 响应 → VS Code 把结果交给模型 → 模型通过 TaoToken 通道生成自然语言回复。你在对话里看到的是「Beijing 当前 22°C晴天」背后是两条独立链路协同工作的结果。5. 本篇常见错排查5.1 406 Not Acceptable最常见的一个。Streamable HTTP 要求客户端在Accept头里同时声明application/json和text/event-stream。VS Code 新版本会自动带上但如果你用 curl 或自己写的客户端漏掉就会 406。检查你的请求头确保两个 MIME 类型都在。5.2 连接被立即关闭 / session 相关报错如果你在 Stateful 模式下遇到 session 找不到的报错检查sessionIdGenerator是否返回了稳定且唯一的 ID以及客户端是否在后续请求里带上了Mcp-Session-Id头。无状态模式下不会出现这个问题因为每个请求都是独立的。调试阶段建议先用无状态模式跑通再按需切 Stateful。5.3 VS Code 里看不到 MCP Server先确认.vscode/mcp.json的路径和格式正确type必须是http。然后确认 Server 进程确实在监听 3000 端口curl -v http://localhost:3000/mcp如果 curl 都连不上问题在 Server 侧如果 curl 能通但 VS Code 看不到检查 VS Code 版本是否支持 Streamable HTTP必要时更新到较新版本。5.4 模型通道返回鉴权错误如果工具调用正常但模型回复报鉴权失败检查 TaoToken 的 Key 是否填对、base URL 是否是https://taotoken.net/api不要多加路径。Key 失效或额度不足也会表现为鉴权错误去控制台确认一下 Key 状态。5.5 工具被调用但参数为空这通常是 zod schema 和客户端传参对不上。检查server.tool里定义的参数名和描述是否清晰模型依赖描述来生成参数。描述写得太模糊模型可能传空值。把describe写具体比如「城市名称例如 Beijing」就比「城市」效果好。6. 长期编码与 Agent 场景的接入建议如果你只是偶尔调试一两个工具上面的骨架够用了。但如果你打算把 MCP Server 长期挂在 Agent 工作流里或者同时跑多个编码任务建议把模型通道升级到 Coding Plan它在长会话和批量请求下的稳定性更好https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite如果你用的是 Claude Code 这类 Anthropic 风格的编码工具接入方式参考https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite回到代码本身有几个实践建议值得记一下。第一无状态模式优先除非你确实需要跨请求维持上下文否则别引入会话管理。第二把 MCP Server 的工具逻辑和 HTTP 层分开工具函数写成纯函数方便单测。第三res.on(close)的清理逻辑别省本地调试看不出问题上了远端就是连接泄漏。第四Key 走环境变量process.env.TAOTOKEN_API_KEY这种别写死在代码里。Streamable HTTP 把 SSE 时代被迫接受的长连接约束解开了Node.js 这边用 SDK 加 Express 几十行就能搭出可用的骨架。真正花时间的不是写 Server而是把 VS Code 配置、模型通道、工具参数这三者对齐。对齐之后整条链路跑起来其实很顺。 
长河君 · 2026/9/29 6:45:40 · 阅读 1.2k 再见，SSE！你好，Streamable HTTP！用 Node.js 轻松开发 Streamable HTTP MCP Server 并配 TaoToken
1. 为什么我要把 MCP Server 从 SSE 迁到 Streamable HTTP如果你最近在 VS Code 里折腾 AI 工具链大概率已经踩过 SSE 的坑MCP Client 和 MCP Server 一旦握手Server 就得在整个连接生命周期里死死抱住这条长连接。本地跑跑还行一旦把 MCP Server 放到远端高并发下连接数直接爆炸负载均衡、超时重连、心跳保活全得自己扛。SSE 不是不能用而是它把「有状态」这件事写死在了协议层开发者没有选择权。Streamable HTTP 的出现改变了这个局面。它把「是否保持状态」的决定权交还给 Server你可以做 Stateless每个请求独立处理水平扩容毫无压力也可以做 Stateful按需维持会话。对写 Node.js 的开发者来说这意味着一个 MCP Server 骨架可以同时适配本地调试和远端部署不用再为 SSE 的长连接做额外架构设计。这篇文章面向在 VS Code 中调试 AI 工具的开发者目标很明确给你一份可复制的 Node.js Streamable HTTP MCP Server 骨架配上mcp.json和config.toml配置片段再通过 TaoToken 的统一 Key/API 通道完成一次真实请求验证。跟着做你能在本地把整条链路跑通而不是停留在「知道有这么个协议」的层面。我试过用旧的 SSE 模板改结果发现连接管理逻辑和 Streamable HTTP 的请求模型对不上索性按新协议重写了一遍。下面把踩过的坑和最终能跑的配置都摊开讲。2. TaoToken 前置统一 Key 与 API 通道准备在写代码之前先把「模型从哪来」这件事定下来。MCP Server 本身只是工具调用的桥梁真正干活的是背后的模型。TaoToken 在这里的角色是提供一个统一的 Key 和 API 通道让你在 VS Code 里调试时不用为每个模型单独配一套凭证。你需要先拿到一个可用的 API Key。访问控制台创建https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建完成后在 API Keys 页面复制你的 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewriteAPI 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base URL 使用。如果你用的是 Anthropic 风格的客户端接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite提示Key 只创建一次就够后续 MCP Server、VS Code 配置、命令行验证都复用同一个 Key。不要把它硬编码进会提交到 Git 的文件里用环境变量或本地配置文件承载。这一步不需要装任何额外软件拿到 Key 和 base URL 就可以进入下一步。整个流程里TaoToken 承担的是「统一入口」的角色你的 MCP Server 通过它调用模型VS Code 通过它连接工具链两边共用一套凭证。3. 可复制配置Node.js Streamable HTTP MCP Server 骨架3.1 初始化项目与依赖先确认 Node.js 版本。Streamable HTTP 相关的 SDK 对 Node 版本有要求建议用 LTSnode -v # 期望输出 v20.x 或更高创建项目目录并初始化mkdir streamable-mcp-demo cd streamable-mcp-demo npm init -y npm install modelcontextprotocol/sdk express zod npm install -D typescript tsx types/node types/express这里用modelcontextprotocol/sdk作为 MCP 协议实现express承载 HTTP 层zod做参数校验。TypeScript 负责类型安全tsx用于开发期直接运行。3.2 核心 Server 代码新建src/server.ts这是整个骨架的核心。Streamable HTTP 的关键在于Server 通过一个 HTTP 端点接收 POST 请求根据请求内容决定是否维持会话。import express from express; import { McpServer } from modelcontextprotocol/sdk/server/mcp.js; import { StreamableHTTPServerTransport } from modelcontextprotocol/sdk/server/streamableHttp.js; import { z } from zod; const app express(); app.use(express.json()); // 创建 MCP Server 实例注册一个天气查询工具作为示例 function createServer() { const server new McpServer({ name: weather-mcp-server, version: 1.0.0, }); server.tool( get_weather, 根据城市名查询当前天气, { city: z.string().describe(城市名称例如 Beijing) }, async ({ city }) { // 实际项目中这里调用真实天气 API const mock { city, temperature: 22°C, condition: Sunny }; return { content: [{ type: text, text: JSON.stringify(mock) }], }; } ); return server; } // Streamable HTTP 端点无状态模式每个请求独立处理 app.post(/mcp, async (req, res) { const server createServer(); const transport new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, // 无状态模式 }); res.on(close, () { transport.close(); server.close(); }); await server.connect(transport); await transport.handleRequest(req, res, req.body); }); const PORT process.env.PORT || 3000; app.listen(PORT, () { console.log(Streamable HTTP MCP Server listening on http://localhost:${PORT}/mcp); });这段代码里有两个关键点。第一sessionIdGenerator: undefined表示无状态模式每个 POST 请求都会新建一个 Server 和 Transport 实例请求结束即释放。第二res.on(close)里做清理避免连接泄漏。如果你需要 Stateful 模式把sessionIdGenerator换成一个返回唯一 ID 的函数即可SDK 会自动管理会话映射。3.3 配置 VS Code 的 mcp.json在项目根目录创建.vscode/mcp.json让 VS Code 知道去哪里找你的 MCP Server{ servers: { weather-mcp-server-streamable-http: { type: http, url: http://localhost:3000/mcp } } }注意type字段填http这是 Streamable HTTP 在 VS Code 配置里的标识。旧的 SSE 配置用的是sse类型加一个/sse端点两者不通用。如果你同时保留旧配置建议把 SSE 那条注释掉避免 VS Code 在 Agent Mode 里选错。3.4 配置 config.toml可选用于命令行客户端如果你用支持 TOML 配置的客户端做命令行验证可以加一份config.toml[mcp_servers.weather] type http url http://localhost:3000/mcp这份配置和mcp.json表达的是同一件事只是格式不同。选你实际使用的客户端对应的那份即可。4. 验证请求一次跑通 Streamable HTTP 链路4.1 启动 Servernpx tsx src/server.ts看到Streamable HTTP MCP Server listening on http://localhost:3000/mcp就说明服务起来了。4.2 用 curl 验证协议层先不急着开 VS Code用 curl 直接打一发确认 Streamable HTTP 端点能正确响应 MCP 的 initialize 请求curl -X POST http://localhost:3000/mcp \ -H Content-Type: application/json \ -H Accept: application/json, text/event-stream \ -d { jsonrpc: 2.0, id: 1, method: initialize, params: { protocolVersion: 2025-03-26, capabilities: {}, clientInfo: { name: curl-test, version: 1.0.0 } } }期望返回一个 JSON-RPC 响应包含serverInfo和capabilities字段。如果返回 406 或 400多半是Accept头没带全——Streamable HTTP 要求客户端同时接受application/json和text/event-stream。4.3 在 VS Code 中连接 TaoToken 通道打开 VS Code建议用较新版本进入 Agent Mode。在 MCP 面板里应该能看到weather-mcp-server-streamable-http点击启动。然后在对话里让它调用天气工具帮我查一下 Beijing 的天气如果工具被正确调用并返回了模拟数据说明 MCP 链路通了。接下来把模型通道切到 TaoToken在 VS Code 的模型配置里把 API base URL 设为https://taotoken.net/api填入你之前创建的 Key。这样模型请求走 TaoToken 统一通道工具调用走本地 MCP Server两条链路各司其职。想先在网页端确认模型通道是否正常可以用模型对话页面发一条测试消息https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite4.4 成功结果长什么样一次完整的成功链路是这样的VS Code 发出工具调用请求 → 本地 MCP Server 通过 Streamable HTTP 接收 → 执行get_weather逻辑 → 返回 JSON-RPC 响应 → VS Code 把结果交给模型 → 模型通过 TaoToken 通道生成自然语言回复。你在对话里看到的是「Beijing 当前 22°C晴天」背后是两条独立链路协同工作的结果。5. 本篇常见错排查5.1 406 Not Acceptable最常见的一个。Streamable HTTP 要求客户端在Accept头里同时声明application/json和text/event-stream。VS Code 新版本会自动带上但如果你用 curl 或自己写的客户端漏掉就会 406。检查你的请求头确保两个 MIME 类型都在。5.2 连接被立即关闭 / session 相关报错如果你在 Stateful 模式下遇到 session 找不到的报错检查sessionIdGenerator是否返回了稳定且唯一的 ID以及客户端是否在后续请求里带上了Mcp-Session-Id头。无状态模式下不会出现这个问题因为每个请求都是独立的。调试阶段建议先用无状态模式跑通再按需切 Stateful。5.3 VS Code 里看不到 MCP Server先确认.vscode/mcp.json的路径和格式正确type必须是http。然后确认 Server 进程确实在监听 3000 端口curl -v http://localhost:3000/mcp如果 curl 都连不上问题在 Server 侧如果 curl 能通但 VS Code 看不到检查 VS Code 版本是否支持 Streamable HTTP必要时更新到较新版本。5.4 模型通道返回鉴权错误如果工具调用正常但模型回复报鉴权失败检查 TaoToken 的 Key 是否填对、base URL 是否是https://taotoken.net/api不要多加路径。Key 失效或额度不足也会表现为鉴权错误去控制台确认一下 Key 状态。5.5 工具被调用但参数为空这通常是 zod schema 和客户端传参对不上。检查server.tool里定义的参数名和描述是否清晰模型依赖描述来生成参数。描述写得太模糊模型可能传空值。把describe写具体比如「城市名称例如 Beijing」就比「城市」效果好。6. 长期编码与 Agent 场景的接入建议如果你只是偶尔调试一两个工具上面的骨架够用了。但如果你打算把 MCP Server 长期挂在 Agent 工作流里或者同时跑多个编码任务建议把模型通道升级到 Coding Plan它在长会话和批量请求下的稳定性更好https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite如果你用的是 Claude Code 这类 Anthropic 风格的编码工具接入方式参考https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite回到代码本身有几个实践建议值得记一下。第一无状态模式优先除非你确实需要跨请求维持上下文否则别引入会话管理。第二把 MCP Server 的工具逻辑和 HTTP 层分开工具函数写成纯函数方便单测。第三res.on(close)的清理逻辑别省本地调试看不出问题上了远端就是连接泄漏。第四Key 走环境变量process.env.TAOTOKEN_API_KEY这种别写死在代码里。Streamable HTTP 把 SSE 时代被迫接受的长连接约束解开了Node.js 这边用 SDK 加 Express 几十行就能搭出可用的骨架。真正花时间的不是写 Server而是把 VS Code 配置、模型通道、工具参数这三者对齐。对齐之后整条链路跑起来其实很顺。