Skip to content

MCP:所有会话共用一个后台进程,同时开着的会话都能用工具 - #479

Merged
PathGao merged 5 commits into
mainfrom
worktree-mcp-shared-daemon
Nov 15, 2026
Merged

PathGao merged 5 commits into
mainfrom
worktree-mcp-shared-daemon

Conversation

@PathGao

@PathGao PathGao commented Nov 14, 2026

Copy link
Copy Markdown
Owner

改了什么

同时开着几个 MCP 会话时,只有先启动的那个能用 MoonDigest 的工具,其余每次调用都报 PORT_IN_USE,要等占着端口的会话关掉才轮到下一个。Claude 桌面版会预先起会话,本机同时有 19 个 moondigest-mcp,占着端口的常常是一个没在用的会话。

原因:每个会话的 moondigest-mcp 都想自己监听 47823 等扩展来连,端口只有一个。

现在每个会话的进程不再监听。第一个会话拉起一个共用的后台进程(moondigest-mcp --hub),它占端口、连扩展,把各会话的调用转给扩展,再按请求号把结果交还给发起的会话。扩展一行没改。npm 包还是只带 server.js。

  • 两个会话同时拉起时,抢不到端口的那个后台进程直接退出。
  • 最后一个会话断开 10 分钟后,后台进程自己退出,下一个会话再拉起。
  • 版本更新的会话会换掉旧的后台进程(比较版本号,相同时比 server.js 的修改时间,所以本地改代码不用改版本号)。旧进程马上放开端口,把手上的调用答完再退出,其余会话的下一次调用连新进程。
  • 后台进程中途没了、扩展中途断开、调用超时,报错里都写明「可能已经执行,写操作先看 undo 的 list: true 再重试」。不自动重试。
  • /client 拒绝一切带 Origin 的连接,网页连不上。不是 JSON 对象的消息直接忽略。
  • PORT_IN_USE 现在的意思是端口被别的程序占着,多半是还在跑的旧版 moondigest-mcp。

形状照 BrowserMCP(一个后台进程加每个会话一个转发进程,靠抢端口决出唯一的后台进程,换版本时先答完在途调用,断线不自动重试)。两处没照做:

  • 没有连接口令。BrowserMCP 把口令放在只有本人能读的文件里,防本机其他进程连后台进程。这里本机任何不带 Origin 的进程都能连 /client。改动前别的进程要抢在端口空着时先监听才能让扩展连过去,现在只要有会话开着就能连,范围比以前大。
  • 后台进程不写日志。拉不起来时报错里给出在前台运行的命令。

版本 0.1.2 → 0.2.0,docs/RELEASE.md 里「版本号写在哪」那句跟着改了。

验证

  • macOS 27.2,Node 24。cd mcp && node --test test/*.test.mjs:35 个全过(原 22 个,换掉 1 个,新增 14 个)。node scripts/selftest.mjs:50 个全过。
  • 新加的每个守卫都改坏过一次,对应测试变红:请求号重编、/client 拒绝 Origin、空闲计时、后台进程没了拒掉在途调用、新换旧、旧不换新、等在途调用、非后台进程占端口、掉线会话的在途调用不拖住退出、空闲会话立刻改连、拉起失败、空消息、退出中的进程不转发调用、转发进程自己的超时、不理退出请求的旧进程、握手中被断开要重连。
  • 真扩展(ego 里装的 3.8.2,端口 47823):同时起两个真实的 server.js,再加第三个,三个都读到了同一个 B站视频,共 5 次调用全部成功。同时拉起了两个后台进程,只剩一个在监听。发退出请求后端口空出,没有残留进程。
  • 没测到:Windows(脱离父进程的拉起和工作目录)。两个不同版本的会话在真扩展上互换后台进程,只在测试里用假扩展跑过。mcp/ 的测试只在发版流程里跑,PR 的检查不跑它。
  • 换版本期间有个已知的空档:旧进程答完在途调用前还握着扩展的连接,这段时间连到新进程的会话会收到「没有扩展连着,一分钟内重试」,最长约一分钟。

@PathGao
PathGao merged commit b036eca into main Nov 15, 2026
2 checks passed
@PathGao
PathGao deleted the worktree-mcp-shared-daemon branch November 15, 2026 03:39
@PathGao PathGao mentioned this pull request Nov 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant