Skip to content

README 中文档化的 --mcp 参数在 0.14.2 中未实现 (npx -y bb-browser --mcp 只打印 help 后退出) #235

Description

@cestion

问题描述

README 中 "MCP (Claude Code / Cursor)" 章节给出的启动方式 npx -y bb-browser --mcp 在已发布版本 bb-browser@0.14.2 中无效 —— 进程不会进入 MCP stdio server 模式,而是打印通用 CLI 帮助后直接退出。

复现步骤

npx -y bb-browser --mcp

期望:进程作为 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 里用上。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions