better-ctx MCP 每次启动被连接两次

[chip2020]

better-ctx MCP 每次启动被连接两次

仓库: opensolon/soloncode
版本: v2026.5.15

问题描述

Solon Code 每次启动时，better-ctx MCP Stdio 客户端会被注册两次（重复握手），而非一次，造成通过网关调用。

复现步骤

1. 启动 Solon Code
2. 在活动监视器看better-ctx进程个数是2个，通过询问agent可以直接确认重复注册。
3. 观察 ~/.soloncode/logs/ 下的 soloncode_*.log 文件
4. 搜索关键字 Server response ... name=better-ctx
5. 每次都能搜到两条一模一样的握手记录，时间戳差数行（~80 行左右）

影响

• 每个 Solon Code 会话产生两个 better-ctx 子进程，浪费系统资源
• better-ctx 的响应被双倍处理，可能引起不必要的重复调用

怀疑方向

可能是 MCP 客户端初始化阶段，McpPlugin 或 StdioClient 的连接逻辑被触发了两次（比如在插件加载和会话恢复时各触发一次）。建议检查：

• MCP 工具注册流程中 better-ctx 的连接管理
• 是否在 init 和 resume 阶段各调用了一次

---

日志路径: ~/.soloncode/logs/
配置文件: ~/.soloncode/config.yml
日志这块agent最后查了better-ctx的日志才最终确认的

[chip2020]

补充观察 - 2026-05-18

今天进一步调试后发现，这个"双连"问题还有更严重的副作用：如果试图用进程锁（如 flock、mkdir 锁）阻止第二个进程启动，会导致 Solon Code 整个退出。

详细表现

Solon Code 启动 → fork better-ctx #1 → 正常握手完成
Solon Code 启动中 → fork better-ctx #2 → 被锁拦截 → 等了一会静默退出
Solon Code 等待 #2 的握手响应 → 超时 → 判定初始化失败 → 整个 IDE 退出
分析

MCP 客户端在初始化阶段对同一个 better-ctx 条目发起了两次 spawn，并且要求两次握手都必须成功才算初始化完成。任意一个失败（包括被锁拦截），都会触发退出逻辑。

带来的影响

用户无法用进程锁去"绕开"这个 bug，锁只会把问题从"双进程"升级为"IDE 启动失败"
当前唯一可行的 workaround 是让两个进程都正常启动（不做拦截），代价是多一个冗余子进程
better-ctx 本身需要做去重/单例保护，否则后续可能因双进程竞争资源引发数据问题
Root cause 确认

McpPlugin 或 StdioClient 在初始化阶段对同一个工具条目发起了两次连接。建议优先定位为什么同一个 mcpServers.better-ctx 会被注册两次。

[chip2020]

抱歉上面的描述都是AI写的，可能会有些让人疑惑。我大概描述下问题：

在mcp段配好better-ctx后，启动问agent “有多少mcp工具，是否重复注册，工具能否直接调用”。

• agent回答会确认重复注册，工具通过网关调用，通过网关调用跟mcp说明文档最后的描述一致。
• 问题是同一个mcp不该被注册两次。
• soloncode启动后，活动监视器可以看到启动了两个better-ctx进程。

后面的补充，来源于我想绕过这个bug。

• 通过在第一次调用better-ctx后加锁，不允许后续执行。确实可以锁上，活动监视器上只看到一个better-ctx进程。
• 但soloncode无法启动，过段时间会自行退出。同时关闭这个better-ctxi进程

Config.yml配置项如下：
soloncode:
mcpServers:
better-ctx:
type: "stdio"
command: "better-ctx"
args: ["mcp"]
#command: "bash"
#args: ["-c", "rm -f /tmp/soloncode-better-ctx.lock && mkdir /tmp/soloncode-better-ctx.lock 2>/dev/null || exit 0; exec ~/.cargo/bin/better-ctx mcp; rmdir /tmp/soloncode-better-ctx.lock 2>/dev/null"]

[noear]

谢谢反馈。。。我研究一下

[chip2020]

谢谢反馈。。。我研究一下

不客气，看好你的项目

[noear]

谢谢支持啊：）。。。项目是不错的。不过，没啥流量啊：）

[chip2020]

慢慢来，只要好用，总能等到爆发的时机

…

---原始邮件--- 发件人: ***@***.***> 发送时间: 2026年5月18日(周一) 晚上6:23 收件人: ***@***.***>; 抄送: ***@***.******@***.***>; 主题: Re: [opensolon/soloncode] better-ctx MCP 每次启动被连接两次 (Issue #26) noear left a comment (opensolon/soloncode#26) 谢谢支持啊：）。。。项目是不错的。不过，没啥流量啊：） — Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications on the go with GitHub Mobile for iOS or Android. You are receiving this because you authored the thread.Message ID: ***@***.***>

[chip2020]

谢谢反馈。。。我研究一下

有个有趣的问题，我强制Agent用ctx_read代替read，但是它总是会时不时地用read。即使注入到agents.md也不能禁止，我想测一下完全用ctx_read代替会不会省tk。

[noear]

如果你的 read 是指内置的方法，可以在 config.yml 禁掉试一下。

参考：https://solon.noear.org/article/1407

[chip2020]

怎么禁啊？哪个文档啊？

…

---原始邮件--- 发件人: ***@***.***> 发送时间: 2026年5月18日(周一) 晚上6:34 收件人: ***@***.***>; 抄送: ***@***.******@***.***>; 主题: Re: [opensolon/soloncode] better-ctx MCP 每次启动被连接两次 (Issue #26) noear left a comment (opensolon/soloncode#26) 如果你的 read 是指内置的方法，可以在 config.yml 禁掉试一下。 参考：https://solon.noear.org/article/1407 — Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications on the go with GitHub Mobile for iOS or Android. You are receiving this because you authored the thread.Message ID: ***@***.***>

[chip2020]

看到了，我试一下哈

…

---原始邮件--- 发件人: ***@***.***> 发送时间: 2026年5月18日(周一) 晚上6:34 收件人: ***@***.***>; 抄送: ***@***.******@***.***>; 主题: Re: [opensolon/soloncode] better-ctx MCP 每次启动被连接两次 (Issue #26) noear left a comment (opensolon/soloncode#26) 如果你的 read 是指内置的方法，可以在 config.yml 禁掉试一下。 参考：https://solon.noear.org/article/1407 — Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications on the go with GitHub Mobile for iOS or Android. You are receiving this because you authored the thread.Message ID: ***@***.***>

[chip2020]

https://solon.noear.org/article/1407
这样写可以吗？
disallowedTools: read 还是 disallowedTools: "read"

[noear]

disallowedTools: read 还是 disallowedTools: "read" 。。。都行。接收它的是 List<String> 。。。多个的话：

soloncode:
  disallowedTools: ["read","bash"]

[chip2020]

disallowedTools: read 还是 disallowedTools: "read" 。。。都行。接收它的是 List<String> 。。。多个的话：

soloncode:
disallowedTools: ["read","bash"]
我试了，agent反馈，没起作用，下面是他的回复，ai的聪明程度让人赞叹啊

看到了。第 22 行 disallowedTools: "read" 确实写着，但 read 仍然能调用。
根据官方文档的那个工具权限表，原因很清楚：
根因
edit 工具的定义是 "文件编辑（含 write、edit、read）"——它把 read 打包在了里面。你只禁了顶层的 read，但 edit 工具本身还带着读能力。tools: "**" 把 edit 放开了，所以文件仍然能读。

[chip2020]

谢谢支持啊：）。。。项目是不错的。不过，没啥流量啊：）

说实在话，觉得你这项目有点牛逼，我已经做完一个小项目了，正在做第二个更大的。过程有曲折，但只要了解配合Agent感觉就没有完不成的任务。当然这个问题我没办法，得找你了。你这个项目是我用的第一个code agent，没用过opencode什么的，我是你的agent+ds v4 flash，感觉很强悍哈哈哈。坚持到底啊

[chip2020]

谢谢支持啊：）。。。项目是不错的。不过，没啥流量啊：）

说实在话，觉得你这项目有点牛逼，我已经做完一个小项目了，正在做第二个更大的。过程有曲折，但只要了解配合Agent感觉就没有完不成的任务。当然这个问题我没办法，得找你了。你这个项目是我用的第一个code agent，没用过opencode什么的，我是用的agent+ds v4 flash，感觉很强悍哈哈哈。坚持到底啊