stdio MCP 断点调试(VS Code Attach + MCP Inspector + Node --inspect) 目标 让用户能够在 VS Code 里稳定命中断点 ,调试通过 stdio 运行的 MCP Server(通常由 启动),并在遇到端口占用、sourcemap 缺失、断点灰色等问题时有清晰的排查路径。 Quick Start(最短用法) 你已经有构建产物(例如 或 ),要对 stdio MCP Server 打断点: - 确保 sourcemap 开启 (构建产物旁边能看到 文件) - 在 MCP 项目根目录的 新增一个 attach 配置 - VS Code 里先启动这个 Attach 调试 - 终端运行(端口要和 launch.json 一致): 如果你发现“断点不进 / 断点灰色”,先改成: 原理(人话版) - Node 的 :会在本机开一个“调试口”(默认就是 9229),VS Code 能连进去控制断点/单步。 - MCP Inspector :相当于一个“临时 MCP 客户端 + UI”,它会启动你的 server,并通过 stdio 跟它对话。 - sourcemap :把“构建后的 JS”映射回“你的 TS 源码”,这样你在 TS 上打断点才会准确。 输出格式(请始终按这个模板给用户) 请输出以下 3 块内容(都要可复制粘贴): 关键约束…