CLI

Bridgent 提供四个命令:

命令	做什么	常见用法
bridgent init [file]	创建 starter MCP server 文件	首次上手
bridgent dev <file>	用 TS 支持 spawn node <file>	通过 stdio 做本地 IDE Agent 集成
bridgent serve <file>	用 TS 支持 spawn node <file>	共享 HTTP 服务器(当文件调用 createHttpServer 时)
bridgent inspect <file>	对你的服务器打开官方 MCP Inspector	不带 LLM 调试工具调用

一个常见误解

bridgent dev 和 bridgent serve 是同一份实现。 两者都在你的文件上 spawn Node 并继承 stdio。传输由你的文件做了什么决定,而不是由哪个 CLI 命令启动它:

• 文件调用 createStdioServer → 走 stdio
• 文件调用 createHttpServer → 监听 HTTP
• 文件调用 createWebHandler 再适配到 Node listener → 也是 HTTP

dev 和 serve 作为两个名字存在,仅仅是为了贴合用户意图(本地试玩 vs. 跑进程)。它们产生的是同一个子进程。如果 bridgent serve foo.ts 没绑定端口,那是因为 server 文件根本没调 createHttpServer。

TypeScript 无需构建

对于 .ts、.tsx、.mts 文件,dev、serve、inspect 都把这些 flag 传给 Node:

--experimental-strip-types --no-warnings=ExperimentalWarning

需要 Node ≥ 22.18。更低版本会在安装时失败(workspace 设置了 engines-strict=true)。没有 tsx、没有 ts-node、不需要构建步骤 —— Bridgent 用 Node 内置的 stripper。

如果你的项目还没用 Node 22.18,用 nvm use 22.18 或 volta install node@22.18 切换。

init

bridgent init ./server.ts
# 覆盖已有目标:
bridgent init ./server.ts --force

创建一个小型、可编辑的 server 文件,使用 @bridgent/core、Zod 和 createStdioServer。它不会安装依赖,也不会创建隐藏配置文件;生成出来的 server.ts 就是你可以直接编辑的运行入口。

dev

bridgent dev ./server.ts
# or
bridgent dev ./server.js

• 继承 stdio(你的 console.log 会出现在 host 日志里)
• 把 SIGINT / SIGTERM 转发给子进程
• 用子进程的退出码退出

在 IDE 的 command 配置里使用——Claude Code、Cursor、Codex CLI、Gemini CLI 都支持 spawn 一个二进制。

serve

bridgent serve ./server.ts

与 dev 实现一致 —— 见上面的 一个常见误解。这个名字存在是为了让 launchd / systemd / pm2 / Docker 单元能用更常见的动词。

inspect

bridgent inspect ./server.ts

包装官方的 @modelcontextprotocol/inspector,通过 stdio 连接到你的 server 文件。它会打开浏览器窗口,让你列出工具、发送 tools/call 载荷、查看 trace —— 全程不需要 LLM。

底层是这样:

# pnpm shells:
pnpm dlx @modelcontextprotocol/inspector node --experimental-strip-types --no-warnings=ExperimentalWarning ./server.ts

# fallback:
npx -y @modelcontextprotocol/inspector node --experimental-strip-types --no-warnings=ExperimentalWarning ./server.ts

所以 bridgent inspect 等价于上面那些命令,只是帮你省了几下敲键。使用走查见 探查与调试。