mcpb (Albatrosso)

mcpb

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

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

特性

• 运行时浏览器发现，没有硬编码的已安装应用程序列表
• 通过不区分大小写的浏览器选择 `mcpb open --

`

• 浏览器已运行时的安全重启提示
• MCP模式专用用户数据目录
• 准备粘贴常见MCP客户端的配置代码片段

需求

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

安装

从存储库构建和安装：

cargo install --path .

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

cargo run -- open --

用法

在MCP模式下打开浏览器：

mcpb open --

覆盖调试端口：

mcpb open -- --port 9333

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

Browser "" 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 在发现过程中跳过捆绑包，而不是中断命令。