MCP Browser

MCP Browser

一款原生 macOS 网页浏览器，可作为 Model Context Protocol 服务运行，让 AI Agent 像真人一样操作真实的 WKWebView——导航、点击、填写表单、读取 DOM、截取屏幕截图、运行 JavaScript，以及捕获网络和控制台活动。

使用 SwiftUI + WKWebView 构建。MCP 服务通过本地 HTTP 在进程内运行，并采用 bearer-token 身份验证和 DNS 重绑定防护。

下载

⬇ 下载最新的 macOS 版本 — 适用于 Apple Silicon 的签名并经过公证的 .dmg。

下载后，打开 DMG，并将 MCP Browser 拖到 Applications 文件夹。

截图

为什么选择 MCP Browser

大多数面向 Agent 的“浏览器即工具”方案分为两类：

1. 无头自动化（Playwright、Puppeteer）——速度快、便于编写脚本，但 Agent 看不到你看到的内容，无法共享你已登录的会话，而且使用的浏览器引擎也不是你信任的那个。
2. 远程控制的云端浏览器——你的数据会离开本机，而且每个会话都要付费。

MCP Browser 是第三种选择：在 Mac 上打开一个真实的浏览器窗口，由你登录、导航并亲自使用；当你提出要求时，大模型也能通过 MCP 操作它。Cookie、历史记录、书签和下载内容都会保留在本地。Agent 看到的页面与你看到的相同。

功能

浏览器

• 基于 WKWebView 的标签页，配有 Safari 风格的标签栏（网站图标、悬停关闭、等宽圆角标签）
• URL 栏，支持历史记录和书签自动补全
• 书签栏、完整的书签管理器、历史记录视图、下载弹出窗口
• 页面内查找、按站点保存缩放设置、画中画控制器
• 书签导入器（HTML / Safari / Chrome 格式）
• 按标签页捕获 Cookie 和网络活动

MCP 服务

• 本地 HTTP 传输，端口为 8833（可配置）——POST /mcp 用于 JSON-RPC，GET /mcp 用于 SSE 风格的状态查询
• Bearer-token 身份验证，每次启动时生成独立令牌，可在 Settings 中重新生成
• DNS 重绑定防护——根据 127.0.0.1 / localhost 验证 Host 标头
• 通过 MCPRegistrar 自动注册常见的 MCP 客户端（Claude Desktop、Codex 等）
• 工具操作日志——记录每次工具调用的参数、结果摘要和耗时

工具（当前目录）

• 导航——navigate、back、forward、reload、current_url、current_title
• 标签页——list_tabs、new_tab、switch_tab、close_tab
• DOM——click、fill、submit、hover、press_key、type_text、scroll、find_in_page、get_element、accessibility_tree
• 页面内容——read_text、read_page、page_metadata、screenshot、pdf_export、render_html、eval_js、find、list_links、list_forms
• Cookie / 存储——get_cookies、set_cookie、storage、clear_session
• 书签——list_bookmarks、open_bookmark_folder
• 检查——console_logs、network_log、dialog
• 文件——download、upload_file（需用户授权）
• 其他——wait_for、emulate、resize

权威列表请参阅 MCP Browser/MCP/MCPToolCatalog.swift。

隐私与安全

• 每次启动生成一个 bearer token——不具备令牌的客户端会收到 401 Unauthorized
• Origin / Host 验证——阻止恶意本地网页发起 DNS 重绑定攻击
• 下载、上传及任何 dialog 交互都需要用户确认
• 默认仅限本地访问——服务绑定到 127.0.0.1，不会连接到公共网络
• Settings 中的操作日志——你可以准确查看 Agent 在浏览器中执行过的操作

系统要求

• macOS 14+（Sonoma 或更高版本）
• 从源代码构建需要 Xcode 16+

开始使用（用户）

1. 从 Releases 页面下载最新的 DMG。
2. 将 MCP Browser 拖到 /Applications，然后启动它。
3. 打开 Settings → Connection，复制 bearer token 和 MCP 端点 URL。
4. 在你的 MCP 客户端（Claude Desktop、Codex 等）中添加该服务。应用的 Settings → MCP Clients 标签页可以自动为最常用的客户端修改配置。
5. 按平常的方式浏览。当大模型需要在网页上执行操作时，它会通过 MCP 调用工具，你可以在日志中看到相关操作。

开始使用（开发者）

1. 克隆此仓库。
2. 在 Xcode 中打开 MCP Browser.xcodeproj。
3. 选择 MCP Browser 方案。
4. 在 My Mac 上构建并运行。

CLI 构建：

xcodebuild -project "MCP Browser.xcodeproj" -scheme "MCP Browser" -configuration Debug build

构建你自己的分支

项目附带原作者的签名设置。如果你要创建分支并构建、发布自己的副本：

1. 开发团队 — 在 Xcode 中打开 MCP Browser target → Signing & Capabilities → 选择你自己的团队。这会重写 MCP Browser.xcodeproj/project.pbxproj 中的 DEVELOPMENT_TEAM。
2. Bundle 标识符 — 将 PRODUCT_BUNDLE_IDENTIFIER 从 com.moosia.mcp-browser 改为你自己的标识符。
3. 不包含 API 密钥。 MCP Browser 本身不会调用任何大模型提供商，只会向连接的客户端提供工具。

配置 MCP 客户端

大多数 MCP 客户端都支持 HTTP 传输配置块。claude_desktop_config.json 的示例：

{
  "mcpServers": {
    "mcp-browser": {
      "transport": "http",
      "url": "http://127.0.0.1:8833/mcp",
      "headers": {
        "Authorization": "Bearer <token-from-settings>"
      }
    }
  }
}

内置的 MCP Clients 设置标签页可以为它支持的客户端（Claude Desktop、Codex 等）写入此配置 — 选择客户端，点击 Add MCP Browser，它就会直接修改配置文件。

每次在 Settings → Connection 中点击 Regenerate token 时，令牌都会轮换。轮换后请重新修改客户端配置。

数据存储

• 书签、历史记录、按主机保存的缩放比例、下载内容和操作日志会通过 PersistentStore（基于文件）以及适用情况下的 SwiftData 本地存储。
• bearer token 存储在 UserDefaults 中。你可以随时在 Settings → Connection 中重新生成令牌，以撤销现有客户端的访问权限。
• 网站图标会缓存在 Application Support 下的磁盘上。
• 无遥测，无云同步。除非你调用的 MCP 工具触发了相关操作，否则任何数据都不会离开本机。

项目结构

MCP Browser/
├── Browser/         WKWebView wrapper, tab model, presenter, scripts, PiP
├── MCP/             MCP server, JSON-RPC, host protocol, tool catalog
│   ├── Registrar/   Auto-config patcher for Claude Desktop / Codex / etc.
│   └── Tools/       Tool implementations (navigation, DOM, content, etc.)
├── Settings/        Settings tabs (general, privacy, connection, recorder, etc.)
├── Storage/         Bookmarks, history, downloads, favicons, action log
├── Views/           Bookmarks bar, bookmarks manager, history, downloads popover
├── ContentView.swift     Top-level window layout, tab strip, URL bar
├── AppCommands.swift     Menu bar commands and keyboard shortcuts
└── MCP_BrowserApp.swift  App entry point and environment wiring

关键文件

• MCP/MCPServer.swift — 基于 NWListener 的 HTTP/JSON-RPC 服务、身份验证和重绑定防护
• MCP/MCPCoordinator.swift — 将工具调用路由到焦点窗口的活动标签页
• MCP/MCPToolCatalog.swift — 所有已提供工具的注册表
• MCP/MCPSecret.swift — 由 Keychain 支持的 bearer token
• Browser/BrowserTab.swift — 封装 WKWebView 的逐标签页 @Observable 模型
• Browser/WebViewHost.swift — NSViewRepresentable 桥接层

安全模型

MCP Browser 特意以非沙盒方式运行，以便：

• 修改 ~/Library/Application Support / ~/.config 中的 MCP 客户端配置文件
• 在明确请求时驱动其他应用（例如打开外部协议）

它不会：

• 绑定除环回地址（127.0.0.1）之外的任何网络接口
• 接受缺少每次启动时生成的 bearer token 的连接
• 接受 Host 标头与 127.0.0.1 或 localhost 不匹配的请求（防御 DNS 重绑定）
• 自行向本机之外发送任何内容

如果你关注代码审计，整个 HTTP 接口都位于 MCP Browser/MCP/MCPServer.swift 中，大约有 400 行。

已知限制

• 目前无法通过 UI 追溯搜索操作日志。
• 支持多窗口，但 MCP 协调器只会将请求路由到最近获得焦点的窗口。
• 网站的 OAuth 和基本身份验证流程由 WebKit 处理；MCP Browser 本身不会存储密码。目前请通过 Safari/Chrome 导入功能使用系统钥匙串。
• 没有移动版/iOS 版本——这是一款仅适用于 Mac 的工具。

参与贡献

有关如何报告 bug、请求功能和提交拉取请求，请参阅 CONTRIBUTING.md。

许可证

MIT