Chromium浏览器MCP模式启动器

mcpb是一款macOS命令行工具,用于以MCP兼容模式启动基于Chromium的浏览器,并提供配置片段。

  • by Albatrosso
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 Albatrosso/mcpb

使用说明

mcpb

mcpb 是一个小型macOS CLI,用于在MCP兼容模式下启动基于Chromium的浏览器。

它从以下位置动态查找浏览器 /Applications 和 ~/Applications,在需要时重新启动它们,使用专用的MCP配置文件启动它们,并打印Claude Desktop、Claude Code和Codex的可粘贴配置片段。

特性

  • 运行时浏览器发现,没有硬编码的已安装应用程序列表
  • 通过不区分大小写的浏览器选择 mcpb open --<browser>
  • 浏览器已运行时的安全重启提示
  • MCP模式专用用户数据目录
  • 准备粘贴常见MCP客户端的配置代码片段

需求

  • macOS
  • 安装在中的基于Chromium的浏览器 /Applications 或 ~/Applications
  • Rust 1.86+从源代码构建

安装

从存储库构建和安装:

cargo install --path .

如果您更喜欢不安装的本地开发版本:

cargo run -- open --<your browser name>

用法

在MCP模式下打开浏览器:

mcpb open --<your browser name>

覆盖调试端口:

mcpb open --<your browser name> --port 9333

当浏览器已经在运行时, mcpb 在重新启动之前要求确认:

Browser "<your browser name>" must be restarted for MCP mode. Close it now? [Y/n]

成功后,它会打印:

  • 本地调试端点
  • Claude桌面JSON代码片段
  • 一 claude mcp add-json 克劳德代码命令
  • 一 config.toml 食品法典委员会

支持的匹配

浏览器标志的匹配不区分大小写:

  • 这 .app 捆绑包名称
  • CFBundleName
  • CFBundleExecutable

示例:

  • mcpb open --brave
  • mcpb open --BrAvE
  • mcpb open --dia
  • mcpb open --chrome

发展

运行测试套件:

cargo test

设置代码格式:

cargo fmt

备注

  • mcpb 故意只使用当前版本的macOS。
  • 它始终使用专用的MCP浏览器配置文件,而不是默认的浏览器配置文件。
  • 畸形的 .app 在发现过程中跳过捆绑包,而不是中断命令。