1. 从 stdio 到 SSENode.js MCP 服务端为什么要换传输层如果你之前跟着教程写过一个 stdio 模式的 MCPModel Context Protocol服务端大概率会遇到一个尴尬它只能被本地进程用管道方式拉起编辑器或 AI 工具链必须自己spawn一个 node 进程环境依赖、路径、日志全绑死在一起。一旦你想让多个客户端共用、想放到容器里、想远程调试stdio 就不好使了。SSEServer-Sent Events模式解决的就是这件事。MCP 服务端跑成一个常驻 HTTP 服务客户端通过GET /sse建立一条长连接接收服务端推送再通过POST /messages?sessionIdxxx把请求发回来。对本地开发调试来说这套模型的好处很直接服务端独立启动、独立看日志、独立重启客户端只认一个 URL。这篇要交付的东西很具体一个能跑的 Node.js MCP SSE 服务端骨架、一份可直接复制的settings.json配置、SSE 端点的验证命令以及接入 TaoToken 统一 Key 后常见的报错排查清单。适合已经在写 MCP、但被 stdio 的进程耦合卡住的同学。核心检索词就三个Node.js、MCP、SSE。需要先说明一点MCP 服务端本身不负责调用大模型它负责暴露工具tools给客户端。真正跟模型对话的那一环是客户端拿着 Key 去请求模型接口。所以「统一 Key 接入」这件事落在客户端配置和你的工具实现里而不是 SSE 传输层。下面会把这两层拆开讲清楚避免你把鉴权和传输混在一起调。2. TaoToken 前置统一 Key 与 API 通道怎么摆在动手写 SSE 之前先把 Key 和通道这件事定下来否则后面调试会分不清是传输问题还是鉴权问题。TaoToken 在这里扮演的角色是统一入口你拿到一个 Key通过https://taotoken.net/api这个 API 通道去访问模型能力不用为每个模型单独维护一套地址和凭证。对 MCP 工具链来说这意味着你的工具函数里请求模型时base URL 和 Key 都从环境变量读代码里不写死。官网地址是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 通道是https://taotoken.net/api这个不加 UTM。Key 的创建入口在控制台的 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。我建议你把 Key 放进.env而不是塞进settings.json明文里。原因很实际settings.json经常被复制粘贴、被提交到仓库、被贴到聊天窗口Key 一旦泄露就得重新生成。用环境变量注入配置骨架可以随便分享。注意MCP 的 SSE 传输层不做模型鉴权它只负责消息通道。模型鉴权发生在你的工具实现或客户端请求里。把这两件事分开排查效率会高很多。如果你后面要做长期编码或 Agent 类任务可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。纯调试阶段用按量 Key 就够了。3. 可复制配置Node.js SSE 服务端 settings.json 骨架3.1 项目初始化与依赖先建目录、初始化、装依赖。MCP 的 SDK 包名是modelcontextprotocol/sdkSSE 传输在server/sse.js子路径下。mkdir mcp-sse-demo cd mcp-sse-demo npm init -y npm i express modelcontextprotocol/sdk -S npm i typescript ts-node types/express types/node -D npx tsc --inittsconfig.json里把outDir设成distrootDir设成srcmodule用commonjs或nodenext都行target建议ES2022。然后在package.json的scripts里加两条{ scripts: { build: tsc, start: node dist/index.js } }3.2 SSE 服务端骨架新建src/index.ts。核心是三件事注册一个GET /sse建立传输、注册一个POST /messages处理回传、用一个 map 按sessionId管理多条连接。import express, { Request, Response } from express; import { McpServer } from modelcontextprotocol/sdk/server/mcp.js; import { SSEServerTransport } from modelcontextprotocol/sdk/server/sse.js; import { z } from zod; const app express(); app.use(express.json()); // 按 sessionId 保存每条 SSE 连接对应的 transport const transports: { [sessionId: string]: SSEServerTransport } {}; function buildServer() { const server new McpServer({ name: demo-sse-mcp, version: 1.0.0 }); // 注册一个示例工具把文本转成大写 server.tool( to_upper, { text: z.string().describe(要转换的文本) }, async ({ text }) ({ content: [{ type: text, text: text.toUpperCase() }], }) ); return server; } app.get(/sse, async (_req: Request, res: Response) { const transport new SSEServerTransport(/messages, res); transports[transport.sessionId] transport; res.on(close, () { delete transports[transport.sessionId]; }); const server buildServer(); await server.connect(transport); }); app.post(/messages, async (req: Request, res: Response) { const sessionId req.query.sessionId as string; const transport transports[sessionId]; if (transport) { await transport.handlePostMessage(req, res); } else { res.status(400).send(No transport found for sessionId); } }); const port Number(process.env.PORT) || 8080; app.listen(port, () { console.log(MCP SSE server running on http://127.0.0.1:${port}); });这里有个容易踩的点SSEServerTransport的第二个参数是响应对象构造时它会立刻把 SSE 头写出去所以GET /sse这个 handler 里不要再手动res.send任何东西否则会报「headers already sent」。3.3 settings.json 配置骨架客户端侧以 Cursor 为例的settings.json或 MCP 配置里SSE 模式只需要一个url字段不需要command和args{ mcpServers: { demo-sse-mcp: { url: http://127.0.0.1:8080/sse } } }如果你希望把模型 Key 也统一走 TaoToken可以在工具实现里读环境变量而不是写进这份 JSONexport TAOTOKEN_API_KEY你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/api然后在工具函数里用process.env.TAOTOKEN_BASE_URL拼请求地址。这样settings.json可以安全地分享给同事Key 留在各自机器上。4. 验证请求跑通 SSE 连接与一次工具调用4.1 启动服务npm run build npm run start看到MCP SSE server running on http://127.0.0.1:8080就说明进程起来了。4.2 用 curl 验证 SSE 端点先验证GET /sse能不能建立长连接。这条命令会挂住并持续输出事件按CtrlC退出curl -N http://127.0.0.1:8080/sse正常的话你会先看到一行event: endpoint后面跟着data: /messages?sessionIdxxxxxxxx。这个sessionId就是后续 POST 要带的凭证。如果这里卡住没有任何输出说明 transport 没建立成功回去检查GET /ssehandler 里是不是多写了res.send。拿到sessionId后另开一个终端发一条 JSON-RPC 请求测试工具列表curl -X POST http://127.0.0.1:8080/messages?sessionId你的sessionId \ -H Content-Type: application/json \ -d {jsonrpc:2.0,id:1,method:tools/list,params:{}}返回里应该能看到to_upper这个工具的定义。再调一次工具curl -X POST http://127.0.0.1:8080/messages?sessionId你的sessionId \ -H Content-Type: application/json \ -d {jsonrpc:2.0,id:2,method:tools/call,params:{name:to_upper,arguments:{text:hello mcp}}}预期结果是HELLO MCP。注意工具调用的结果是通过 SSE 那条长连接推回来的POST 请求本身只返回一个接收确认所以你要在第一个终端里看输出。这是 SSE 模式和普通 REST 最大的区别很多人第一次调会以为 POST 没返回就是失败了。4.3 在客户端里接入把 3.3 的settings.json片段填进客户端的 MCP 配置重启客户端。连接成功后工具列表里会出现to_upper。如果客户端支持模型对话调试可以直接在对话里让它调用这个工具验证整条链路。5. 本篇常见错排查清单5.1 报错No transport found for sessionId原因基本是sessionId对不上。要么你 POST 时手抄错了要么 SSE 连接已经断开、res.on(close)把 transport 删掉了。排查方法重新curl -N /sse拿一个新的sessionId立刻用它发 POST。如果每次都要重连才能用说明你的客户端没有保持长连接检查客户端配置里 URL 是否写成了/messages而不是/sse。5.2 报错Cannot set headers after they are sent这是GET /ssehandler 里重复写响应导致的。SSEServerTransport构造时已经接管了响应流你的 handler 里除了server.connect(transport)之外不要再碰res。把多余的res.writeHead、res.send、res.json全删掉。5.3 端口被占用EADDRINUSE8080 被别的进程占了。改端口最省事PORT8090 npm run start同时记得把settings.json里的 URL 改成http://127.0.0.1:8090/sse。查占用进程可以用lsof -i :8080macOS/Linux或netstat -ano | findstr 8080Windows。5.4 客户端连不上但 curl 正常先确认客户端和 curl 用的是同一个地址。常见坑是客户端跑在容器或 WSL 里127.0.0.1指向的不是宿主机。这种情况把 URL 换成宿主机的局域网 IP并确认服务监听在0.0.0.0而不是仅127.0.0.1。app.listen(port)默认监听所有网卡一般不用改。5.5 工具调用返回鉴权错误如果错误信息里出现 401 或 403说明问题不在 SSE 传输层而在你的工具实现请求模型接口那一步。检查TAOTOKEN_API_KEY是否注入成功、TAOTOKEN_BASE_URL是否写成了https://taotoken.net/api。可以在工具函数里临时打印process.env.TAOTOKEN_BASE_URL确认。Key 的创建和查看在控制台https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。5.6 打包后dist里缺文件tsc只编译.ts如果你有.json之类的资源文件需要额外拷贝。另外确认tsconfig.json的include覆盖了srcoutDir和package.json里start指向的路径一致。跑npm run build后ls dist看一眼有没有index.js。6. 把 Key 和传输层彻底解耦写到这里SSE 这条链路应该已经能跑通了。回头看真正让调试变顺的不是代码本身而是把两件事分开了SSE 负责消息通道TaoToken 统一 Key 负责模型鉴权。传输层出问题就看sessionId和长连接鉴权出问题就看环境变量和 base URL两边互不干扰。如果你只是本地调试单个工具按量 Key 加这份骨架就够了。等你要跑长期编码任务、或者让 Agent 连续调用多个工具时再考虑用 Coding Plan 把额度固定下来https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。想先在网页里验证模型通道是否通可以直接用模型对话https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite。接入细节和参数说明都在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。最后留一个我踩过的坑sessionId是每次建立 SSE 连接时动态生成的不要把它写进任何配置文件里当固定值。客户端每次重连都会拿到新的写死了必然报No transport found。