safari-mcp
macOS Safari 浏览器 AI 自动化 MCP 服务器,80+ 工具,零 CPU 开销,原生保持登录态
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
macOS Safari 浏览器 AI 自动化 MCP 服务器,80+ 工具,零 CPU 开销,原生保持登录态
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。

想象这样一个场景:你让 Claude Code 自动化完成 GitHub PR 评审,或者让 Cursor 帮你抓取一个动态网页的数据——这些任务都需要一个真实的浏览器:保持登录态、执行 JavaScript、渲染动态内容。
传统方案是 Chrome DevTools MCP(Google 官方出品),但它有两个致命问题:
Safari MCP 的出现,就是来解决这两个痛点的。
Safari MCP 是 achiya-automation 团队开源的 Model Context Protocol(MCP)服务器,专门用于将 macOS Safari 浏览器暴露为 AI Agent 可调用的工具集。截至 2025 年,它提供 80+ 原子工具,覆盖:
| 类别 | 代表工具 | 功能 |
|---|---|---|
| 导航 | navigate_to、go_back、go_forward、reload | 页面跳转与刷新 |
| 内容提取 | get_text、get_links、get_images、extract_tables | 抓取页面结构化数据 |
| 截图/PDF | take_screenshot、capture_element、export_pdf | 视觉输出 |
| 表单操作 | detect_form、fill_input、select_option、submit_form | 表单填写提交 |
| 网络监控 | get_network_requests、get_response_body、monitor_network | 抓包分析 |
| Cookie/存储 | get_cookies、set_storage、get_local_storage | 状态持久化 |
| 辅助功能 | get_accessibility_tree、focus_element、hover | 无障碍与交互 |
核心技术亮点:双引擎架构
index.js (MCP Server)
├── Safari Web Extension(快速,5-20ms,自动保持登录)
│ └── HTTP polling 通信(Safari WebSocket 被 Apple 禁用)
└── AppleScript + Swift Daemon(兜底,始终可用)
└── 精确控制 Safari 的 UI 脚本
双引擎设计保证了稳定性:扩展连接时用扩展(快),扩展断开时用 AppleScript 兜底。
80 个工具覆盖了浏览器自动化的方方面面,比 Chrome DevTools MCP 的工具更丰富、更贴近实际业务场景。特别值得一提的是网络监控工具——可以直接抓取 API 请求的 Request/Response body,这在 AI Agent 需要分析网页动态加载数据时极其有用。
通过 @modelcontextprotocol/sdk 实现标准化 MCP 接口,兼容:
# 安装
npm install -g safari-mcp
# Claude Code 配置(~/.claude.json)
{
"mcpServers": {
"safari": {
"command": "npx",
"args": ["safari-mcp"]
}
}
}
# 重启 Claude Code,即可在 Agent 中使用 Safari 工具
README 提供 Dockerfile,可用于在 Linux 容器中启动 MCP 服务器自省测试(响应 tools/list 等接口),但实际 Safari 自动化功能在非 macOS 环境下不可用。
所有浏览器操作在本地 macOS Safari 中执行,数据不经过任何第三方服务器。AI Agent 通过本地 MCP 协议与 Safari 通信,Cookie、LocalStorage 等浏览器状态保持在本地机器上。这使得 Safari MCP 特别适合处理涉及隐私数据的自动化任务(如自动操作你的个人邮箱、财务后台等)。
Safari MCP 代表了一个新兴趋势:浏览器自动化正在从"无头浏览器"向"真实浏览器+AI协议"演进。
传统的 Puppeteer/Playwright 使用无头 Chromium,每次启动干净浏览器,数据全无。而 Safari MCP 这类 MCP 工具,让 AI Agent 接管用户已有的、保持登录态的真实浏览器,体验更接近"真人操作",同时利用 MCP 协议实现了工具标准化。
随着 AI Coding Agent(Claude Code、Cursor、Windsurf)的爆发式增长,对高质量浏览器自动化工具的需求急剧上升。Safari MCP 精准切入了 macOS 开发者这个细分但高价值的用户群,未来有望成为 Apple 生态 AI 编程的标配工具。
项目主页:https://achiya-automation.com
快速尝鲜:npx safari-mcp
许可证:MIT
主语言:JavaScript
依赖:@modelcontextprotocol/sdk、ws