探查与调试

Bridgent 提供 bridgent inspect 命令,会启动接好你服务器的官方 MCP Inspector。

bridgent inspect ./server.ts

它在内部等价于:

pnpm dlx @modelcontextprotocol/inspector node --experimental-strip-types ./server.ts

Inspector 会打开一个浏览器窗口,你可以:

• 浏览所有已注册的工具及其输入模式
• 用任意参数发送 tools/call 并查看响应
• 回放一条 JSON-RPC trace
• 在 stdio(默认)与 HTTP 之间切换

传入 --probe 后,bridgent inspect 会在浏览器打开前运行一个短超时 metadata probe。如果 server 文件到达 Bridgent transport,CLI 会打印按 source 分组的工具提示、可复制的 stdio / 默认 HTTP host 配置片段,以及 mutating tools、缺 audit metadata、生成工具数量过多等 warning。Probe 会先执行一次 server module,Inspector 随后还会再执行一次,因此只应对初始化幂等且可安全执行两次的 server 启用。这个 probe 是 best-effort:metadata 不可用时,官方 Inspector 仍会照常启动。

为什么不做自定义 UI?

Bridgent 目前故意复用官方 Inspector —— 它能用、有人维护,且覆盖了 80% 的调试场景。一个 Bridgent 专属的 inspector(带数据源分组、鉴权提示、Prisma trace)仍在路线图上,但不应阻塞数据源与 onboarding 工作。

探查远程 HTTP 服务器

如果你已经用 bridgent serve 启动了一个,可以直接通过 Inspector 的 UI 把 URL 喂给它:选择 "Connect to URL",输入 http://127.0.0.1:3333/mcp。