问题描述
README 中 "MCP (Claude Code / Cursor)" 章节给出的启动方式 npx -y bb-browser --mcp 在已发布版本 bb-browser@0.14.2 中无效 —— 进程不会进入 MCP stdio server 模式,而是打印通用 CLI 帮助后直接退出。
复现步骤
期望:进程作为 MCP stdio server 启动,监听 stdin 等待 JSON-RPC 输入。
实际:打印通用帮助文本后 exit 0,从未进入 server 循环。
也尝试发送 initialize 握手验证:
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
| npx -y bb-browser --mcp
同样只输出帮助后退出,没有任何 JSON-RPC 响应。
根因分析
把 0.14.2 的包拉下来解开看了一下:
npm pack bb-browser
tar -xzf bb-browser-0.14.2.tgz
grep -c -i "mcp" package/dist/cli.js
# 输出: 0
dist/cli.js 里 "mcp" / "MCP" 字符串出现 0 次。--mcp 参数在已发布代码里没有任何处理逻辑,被当作未知参数忽略后打印 help 退出。
也就是说 README 文档了这个功能,但实现没打包进 0.14.2。
环境
| 项 |
值 |
| bb-browser |
0.14.2 (2026-05-29 发布) |
| Node |
v22.22.0 |
| npm/npx |
10.9.4 |
| 系统 |
macOS Darwin 23.1.0 (arm64) |
期望修复
两选一:
- ✅ 把 MCP server 实现打包进下一个版本,让 README 文档化的
--mcp 参数真正可用;或
- ⏸️ 暂时从 README 移除 MCP 章节,避免用户按文档配置后连接失败
感谢维护者!bb-browser 看起来是个很棒的项目,期待 MCP 模式上线后能在 Claude Code 里用上。
问题描述
README 中 "MCP (Claude Code / Cursor)" 章节给出的启动方式
npx -y bb-browser --mcp在已发布版本bb-browser@0.14.2中无效 —— 进程不会进入 MCP stdio server 模式,而是打印通用 CLI 帮助后直接退出。复现步骤
期望:进程作为 MCP stdio server 启动,监听 stdin 等待 JSON-RPC 输入。
实际:打印通用帮助文本后 exit 0,从未进入 server 循环。
也尝试发送
initialize握手验证:同样只输出帮助后退出,没有任何 JSON-RPC 响应。
根因分析
把 0.14.2 的包拉下来解开看了一下:
dist/cli.js里 "mcp" / "MCP" 字符串出现 0 次。--mcp参数在已发布代码里没有任何处理逻辑,被当作未知参数忽略后打印 help 退出。也就是说 README 文档了这个功能,但实现没打包进 0.14.2。
环境
期望修复
两选一:
--mcp参数真正可用;或感谢维护者!bb-browser 看起来是个很棒的项目,期待 MCP 模式上线后能在 Claude Code 里用上。