Skip to content

feat(web): 通用 MCP 节点配置面板——设置里管理工具节点,agent 自主调用 - #208

Closed
lonrencn wants to merge 1 commit into
ZJU-REAL:mainfrom
lonrencn:mcp-config-panel
Closed

lonrencn wants to merge 1 commit into
ZJU-REAL:mainfrom
lonrencn:mcp-config-panel

Conversation

@lonrencn

Copy link
Copy Markdown
Contributor

方向:通用 MCP 工具层,与 skill 插槽互补

现状:Easel 对接外部能力走 skill 插槽(.env provider:IMG_BASE_URL / MUSIC_PROVIDER / VOICE_PROVIDER…)。每接一个新平台,都要为对应插槽写一次性适配脚本,agent 能力层与插槽耦合,自有/第三方能力的接入成本高。

MCP 工具层是另一条路:能力做成 MCP 节点挂进来,agent 按任务自主调用,无需逐平台适配。两者互补——插槽适合确定性流水线的固定参数位,MCP 适合 agent 自主选择的通用能力。本 PR 落地后者的基础设施:设置里的 MCP 节点配置面板。

功能

设置新增「MCP 节点」分类:

  • 节点通讯录:stdio / streamable-http 两种 transport,新增 / 删除 / 启停(停用 = agent 工具架临时撤下)
  • 工具总览:实时 MCP 握手拉取每个节点的全量工具清单(名称+描述),自部署实测:SimpAI 111 个、real-browser 18 个、WeKnora 17 个
  • 新增表单:HTTP 远程节点(URL+headers)与本地进程节点(command+args+env)双形态

实现要点

  • 后端 web/mcp_admin.py(独立 APIRouter /api/mcp/*,不改现有路由)
  • 状态所有权在 gateway:所有变更走 scripts/gateway.sh stop → 改 openclaw.json → start(约 20s,串行化 asyncio.Lock,配置 tmp 原子替换)
  • 探测不碰 gateway:HTTP 直连握手(urllib 先行,空响应自动降级 curl HTTP/2——部分前置代理会掐 HTTP/1.1 长请求);stdio 用子进程 JSON-RPC 行协议
  • 前端复用 st-env 卡片规范(tile + pill 徽章 + card-foot),2 列网格

测试(自部署实例,OpenClaw 2026.11.3)

  • 7 节点列表、HTTP 探测(111 工具)、stdio 探测(18/17 工具)全通过
  • 新增 / 启停 / 删除全链路实测,重启后 agent 工具架即时生效
  • tsc -b && vite build 通过(前端零类型错误)

- 后端 web/mcp_admin.py(APIRouter /api/mcp/*):节点增删改/启停/实时探测;
  变更走 gateway.sh stop → 改 openclaw.json → start(状态所有权在 gateway);
  探测不碰 gateway:HTTP 直连握手(urllib 空响应自动降级 curl HTTP/2),
  stdio 用子进程 JSON-RPC 行协议
- 前端设置新增「MCP 节点」分类:节点卡片(tile+pill 徽章,st-env 卡片规范)、
  工具清单实时展开、新增表单(HTTP/本地进程双形态)、删除确认
- 方向:MCP 工具层与 skill 插槽互补——插槽适合确定性流水线的固定参数位,
  MCP 适合 agent 按任务自主调用的通用能力。自有/第三方能力做成 MCP 节点
  挂进来即可用,无需为每个平台写一次性插槽适配
@lidingm

lidingm commented Nov 17, 2026

Copy link
Copy Markdown
Collaborator

感谢提供 MCP 节点通讯录、工具清单探测和设置界面的实现!可视化管理外部工具有价值,但我核对后认为当前实现不能直接作为通用工具层合入。

它实际只改硬编码 ~/.openclaw-easel/openclaw.json,所有变更都控制 OpenClaw gateway;没有向已支持的 Hermes/Codex/OpenCode/通用 ACP 分发配置,界面“全部工具对 agent 可见”的说法不成立,也未复用现有 profile/状态路径解析或活跃任务守卫。修改节点会中断网关会话,本轮没有操作真实网关。

在临时配置和函数/进程替身上复现了三项问题:

  1. _apply_mutation 用 "running" in status 判断,真实脚本的 Gateway not running 也匹配,已停止的服务会被走 stop/start。
  2. _gateway 忽略退出码;模拟启动失败,变更仍返回 ok=True,没有证明新配置已被运行时接受。
  3. curl 备用分支未请求输出响应头,却按头/正文分隔解析 stdout;普通 JSON 响应会丢失正文而导致握手失败。该命令还使用 -k 关闭 TLS 校验。接口错误可能回显节点原始响应,upsert 还返回完整 entry(含 env/headers),需采用现有脱敏约定。stdio 探测使用 select + 阻塞 readline,超时与 Windows 管道兼容性也需重新设计。

建议借鉴通讯录和工具列表界面,后续按当前底座分别接入其支持的 MCP 配置,先做好可验证的状态、凭据展示边界和不中断活跃任务的应用流程,再讨论扩大工具能力。本轮关闭、不合并;感谢贡献。此次复查只用了合成数据,没有真实启动 MCP 节点、修改配置或重启服务。

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.

2 participants