stdio MCP 断点调试（VS Code Attach + MCP Inspector + Node --inspect）

目标

让用户能够在 VS Code 里稳定命中断点，调试通过 stdio 运行的 MCP Server（通常由 npx @modelcontextprotocol/inspector ... 启动），并在遇到端口占用、sourcemap 缺失、断点灰色等问题时有清晰的排查路径。

Quick Start（最短用法）

你已经有构建产物（例如 build/internal/index.js 或 dist/index.js），要对 stdio MCP Server 打断点：

• 确保 sourcemap 开启（构建产物旁边能看到 .map 文件）
• 在 MCP 项目根目录的 .vscode/launch.json 新增一个 attach 配置
• VS Code 里先启动这个 Attach 调试
• 终端运行（端口要和 launch.json 一致）：

npx -y @modelcontextprotocol/inspector node --inspect=9229 build/internal/index.js