Safari MCP

官方

Safari MCP 服务器通过将您的代理连接到 Safari 浏览器窗口,使其能够了解代码在浏览器中的实际渲染效果。

你可以用 Safari MCP 做什么?

  • 检查页面渲染 — 让您的 agent 在 Safari 中打开网站,检查计算样式、布局和页面内容。
  • 调试控制台和网络活动 — 获取缓冲的控制台日志,并列出或检查网络请求的标头、正文和时序。
  • 运行 JavaScript 并捕获截图 — 在页面中执行 JavaScript 以呈现性能指标,或捕获 PNG 截图。
  • 测试交互和用户状态 — 执行 click、type、scroll、hover 和 keyPress 序列,以验证表单和结账流程。
  • 检查无障碍性 — 让您的 agent 查找缺失的标签、不正确的 ARIA 属性和较差的对比度。
  • 模拟视口和媒体 — 以 CSS 像素设置视口大小,或模拟 print 等媒体类型以进行响应式测试。

文档

更新: 在 Safari 27 和 Safari Technology Preview 247 中,我们推出了 Safari MCP 服务器——一个面向 Web 开发者的模型上下文协议(Model Context Protocol)服务器,可让你的 Web 开发和调试工作流更快、更强大。我们知道智能体在编码过程中正变得越来越不可或缺,而 Safari MCP 服务器通过将智能体连接到 Safari 浏览器窗口,使其能够了解你的代码在浏览器中实际渲染的效果。

任何兼容 MCP 的客户端都可以连接到 Safari MCP 服务器。通过将智能体连接到 Safari 浏览器窗口,智能体可以模拟用户体验,从而获得更自主地调试所需的信息,例如访问 DOM、网络请求、截图和控制台输出。

它加快了你的调试流程,让你可以舒适地待在终端里,这意味着更少的窗口切换和更少的提示输入。

使用场景

如果你为 Web 构建内容,那你一定熟悉调试的“舞蹈”。通常流程是这样的:

你在浏览器中发现网站出了问题。你打开控制台去排查。你点进样式标签页。你看到了哪里坏了。你回到代码中去修复它。或者你截个图,把问题详细描述给智能体,让它帮你修复。希望它做对了,bug 修好了,你就可以继续了。

但如果没有修好,你又要走一遍流程——浏览器、提示、智能体。

一次又一次,直到你终于消灭了这个 bug。

无论你使用哪种浏览器或工具,调试工作流都需要大量的点击、工具和窗口切换才能完成一次修复,但其实不必如此。如果你已经在开发工作流中使用智能体,Safari MCP 服务器可以让你的调试更快、更高效。

Safari MCP 服务器使你的智能体能够自行完成更多调试和故障排查工作。以下是它能帮助的一些示例:

在 Safari 中进行 Web 开发。下次你在 Safari 中开发时,你将受益于升级后的工作流。你的智能体已经在帮你处理代码,现在它还可以通过查看你的代码在 Safari 中实际渲染的效果来做更多事情。

改善与 Safari 的兼容性。 只在一个浏览器中测试意味着可能遗漏另一个浏览器中的潜在 bug,让那些用户获得不佳的体验。借助 Safari MCP 服务器,你的智能体可以在 Safari 中打开你的网站,检查计算样式、检查布局,并与你的预期进行对比,而无需切换窗口。

分析性能。 查看网站中哪些部分拖慢了速度。Safari MCP 服务器让智能体可以在页面上执行 JavaScript 来呈现性能指标,例如导航计时和资源加载时间,从而精确定位是什么拖慢了你的网站,并着手进行正确的修复。

检查无障碍性。 Safari MCP 服务器让智能体可以检查常见的无障碍问题,例如缺少标签、不正确的 ARIA 属性以及对比度不佳,从而帮你发现影响用户的问题。

验证任意用户状态。 确认页面运行和显示正常。你的智能体可以检查表单状态、使用选择器查询元素、确认特定交互、展示结账流程的不同状态等等。减少在这些手动检查上花费的时间,让智能体替你完成。

这些只是部分使用场景。无论你决定如何实现,Safari MCP 服务器都能帮助你的智能体为你做更多事情,减少 Web 开发中经常需要的来回折腾。更轻松的工作流意味着消灭更多 bug、更满意的用户和更好的产品。

工具

以下是可用的工具及其功能:

工具描述
browser_console_messages返回当前或指定标签页的缓冲控制台日志
browser_dialogs列出并响应浏览器对话框(接受、关闭或为 JS 提示输入文本)
close_tab通过句柄关闭浏览器标签页
create_tab创建新的浏览器标签页,可选加载 URL
evaluate_javascript在页面中执行 JavaScript 代码并返回结果
get_network_request获取单个已记录网络请求的完整详情(标头、正文、计时)
get_page_content以多种格式(markdown、HTML、JSON 等)提取页面的文本内容
list_network_requests列出当前标签页的网络请求摘要(URL、方法、状态、计时)
list_tabs列出所有打开的浏览器标签页及其句柄和 URL
navigate_to_url导航到 URL 并返回已加载页面的内容
page_info获取当前页面的信息:URL、标题和加载状态
page_interactions按顺序执行 DOM 交互:点击、输入、滚动、悬停、按键等
screenshot将当前页面截取为 PNG 截图
set_emulated_media模拟 CSS 媒体类型(例如“print”)以进行响应式设计测试
set_viewport_size以 CSS 像素设置浏览器视口大小
switch_tab通过句柄切换到不同的浏览器标签页
wait_for_navigation等待当前页面加载完成;返回最终 URL 和标题

借助 Safari MCP 服务器,你不再需要编写完美的提示,仔细向智能体描述你在浏览器中遇到的情况。你可以让智能体自己去发现。

如何开始

Safari 27

首先,你需要安装 Safari 27。安装完成后,请确保启用 Web 开发者功能和远程自动化。要为 Web 开发者启用功能,请选择 Safari > 设置 > 高级 > 勾选“显示 Web 开发者功能”复选框。然后前往 Safari > 设置 > 开发者 > 勾选“允许远程自动化和外部智能体”。

如果你使用 Claude,可以在终端中使用以下命令:

claude mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp

如果你使用 Codex,可以在终端中使用以下命令:

codex mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp

对于其他智能体,你可以将以下内容放入你的 mcp.json 或 config.json 文件中。

{
  "mcpServers": {
    "safari-mcp": {
      "command": "/usr/bin/safaridriver",
      "args": ["--mcp"]
    }
  }
}

Safari Technology Preview

首先,你需要安装 Safari Technology Preview。安装完成后,请确保启用 Safari 设置 > 高级 > 显示 Web 开发者功能。然后前往 Safari 设置 > 开发者 > 启用远程自动化和外部智能体。

如果你使用 Claude,可以在终端中使用以下命令:

claude mcp add safari-mcp-stp -- "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --mcp

如果你使用 Codex,可以在终端中使用以下命令:

codex mcp add safari-mcp-stp -- "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --mcp

对于其他智能体,你可以将以下内容放入 mcp.json 或 config.json:

"safari-mcp-stp": {
  "command": "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver",
  "args": ["--mcp"] 
}

请注意,虽然上面的代码将服务器命名为 safari-mcp-stp,但你可以随意命名,甚至只叫 safari。安装好 Safari MCP 服务器后,试试以下提示之一:

Find bugs on my site in Safari
How accessible is my site in Safari?
See how my website performs in Safari

虽然每个智能体的工作方式略有不同,但应该不需要明确告诉它使用 Safari MCP 服务器——它会自己弄明白。像上面这样的简单提示就足以启动 MCP。

以下是与使用 Safari MCP 服务器的智能体对话的示例:

你:收到一个 bug 报告——航班页面在 Safari 中出了问题。你能查一下是怎么回事吗?

智能体:好的,让我看看。

智能体:我在 Safari 的航班页面上发现了两个不同的 bug。需要我把两个都修好吗?

你:是的。这里还有其他可能给 Safari 用户带来问题的地方吗?

智能体:是的,还有两件事值得注意。结果展示动画悄无声息地坏了,API 服务器启动日志也是错的。需要我把这两个也处理了吗?

你只需要一个初始请求就能开始,在 Safari MCP 服务器的帮助下,你的智能体可以从那里接手。

Safari MCP 服务器完全在你的本地机器上运行,自身不进行任何网络调用。它也无法访问你在 Safari 中的个人信息(例如自动填充或其他浏览器活动)。当它捕获页面内容、截图或控制台日志时,这些数据会直接发送给你正在运行的智能体——而不是发送给 Apple。此后这些数据如何处理取决于你使用的智能体和模型。与任何你授予浏览器访问权限的智能体一样,请只使用你信任的智能体。

我们为什么构建这个

构建 Web 的方式有很多,无论是否使用 AI。如果 AI 是你工作流的一部分,我们认为这个工具将帮助它变得更加高效。如果不是,那也没关系。

通过创建这个资源,我们希望通过帮助你的智能体理解浏览器中事物的外观和工作方式,让在 Safari 中测试和调试变得比以往更容易。

如果你尝试了它,或者这是你第一次使用 MCP 服务器,请告诉我们你的想法。通过 Feedback Assistant 提交问题。

你也可以在网上找到我们:Saron Yitbarek 在 Bluesky,Jen Simmons 在 Bluesky / Mastodon,Jon Davis 在 Bluesky / Mastodon。