FrontMCP 实现 MCP 服务器热重载:0.5 秒重启,Claude Code 不掉线

DavidAntoon · reddit · 2026-10-27

FrontMCP(开源 TypeScript MCP 服务器框架)作者演示了如何让 Claude Code 在同一会话内修改并调用 MCP 服务器的新工具,免去「改完→重启→/mcp 重连」的循环。

用法(三条命令):

npx frontmcp create notes-server

cd notes-server && npm install

claude mcp add --scope project notes-server -- npx frontmcp dev --stdio --serve

最后一条写入 .mcp.json,团队里所有人打开项目都自动用同一服务器。

实测(Claude Code 2.1.310 / Opus 5.5):要求 Claude 调用 add、新增 multiply 工具并调用、再让 add 拒绝负数并验证。每次保存后服务器重启仅需 0.44–0.62 秒,调用立即返回新结果,全程无需手动重启或重连;整个流程 58 秒完成。对照组:同一 prompt 走 HTTP 连 npm run dev(tsx --watch),每次重启约 6 秒,还出现一次 ECONNREFUSED 需重试。

原理:Claude Code 启动的 stdio 桥接进程常驻不退出,以子进程方式跑服务器,监听文件变化后重启子进程、期间挂起调用,并发送 notifications/tools/listchanged 通知客户端刷新工具列表——这正是 Claude Code 文档所说可避免 stdio 服务器被标记失败的关键。保存导致服务器挂掉时调用会等待,30 秒无修复则返回 -32097 devreloaddeadline,真实错误记录在 .frontmcp/dev.log(作者建议在 CLAUDE.md 里注明这一点)。

原文链接 →

「编程与Agent」频道最新

更多「编程与Agent」频道 AI 资讯 →