Safari MCP

官方

Safari MCP 伺服器讓您的代理程式能夠連接到 Safari 瀏覽器視窗,從而了解您的程式碼在瀏覽器中的實際渲染情況。

你可以用 Safari MCP 做什麼?

  • 檢查頁面轉譯 — 請你的代理在 Safari 中開啟網站,並檢查計算樣式、版面配置與頁面內容。
  • 偵錯主控台與網路活動 — 擷取緩衝的主控台記錄,並列出或檢查網路請求,包含標頭、主體與計時資訊。
  • 執行 JavaScript 並擷取螢幕截圖 — 在頁面中評估 JavaScript 以呈現效能指標,或擷取 PNG 螢幕截圖。
  • 測試互動與使用者狀態 — 執行 click、type、scroll、hover 與 keyPress 序列,以驗證表單與結帳流程。
  • 檢查無障礙性 — 請你的代理尋找缺少的標籤、不當的 ARIA 屬性與不良的對比度。
  • 模擬視埠與媒體 — 以 CSS 像素設定視埠大小,或模擬如 print 的媒體類型以進行響應式測試。

文件

更新: 在 Safari 27 和 Safari Technology Preview 247 中,我們推出了 Safari MCP 伺服器——這是一款專為網頁開發者打造的 Model Context Protocol 伺服器,能讓你的網頁開發與除錯流程更快速、更強大。我們知道代理在程式開發過程中扮演的角色日益重要,而 Safari MCP 伺服器能將你的代理連接到 Safari 瀏覽器視窗,讓它了解你的程式碼在瀏覽器中實際的呈現方式。

任何相容於 MCP 的用戶端都能連線至 Safari MCP 伺服器。將你的代理連接到 Safari 瀏覽器視窗後,代理便能模擬使用者實際體驗到的情況,取得更自主除錯所需的資訊,例如存取 DOM、網路請求、螢幕截圖與主控台輸出。

它能加速你的除錯流程,讓你舒適地待在終端機中,減少反覆切換視窗與輸入提示來除錯的次數。

使用案例

如果你從事網頁開發,一定熟悉這種除錯的來回過程。通常情況是這樣的:

你在瀏覽器中發現網站有問題。你開啟主控台追查問題。你點進樣式分頁。你看到哪裡壞了。你回到程式碼修正它。或者,你可能截圖、向代理詳細說明問題,讓它幫你修正。希望它做對了,錯誤修好了,你就能繼續往下走。

但若問題沒修好,你又得再走一遍流程——瀏覽器、提示、代理。

一次又一次,直到你終於把錯誤解決掉。

無論你使用哪種瀏覽器或工具,除錯流程往往需要大量點擊、切換工具與視窗,才能完成一次修正,但其實不必如此。如果你已在開發流程中使用代理,Safari MCP 伺服器能讓你的除錯更快速、更有效率。

Safari MCP 伺服器讓你的代理能自行完成更多除錯與疑難排解工作。以下是它能協助的幾個例子:

在 Safari 中進行網頁開發。下次你在 Safari 中開發時,將能享有升級後的工作流程。你的代理原本就能協助你處理程式碼,現在它還能進一步檢查你的程式碼在 Safari 中實際的呈現方式。

改善與 Safari 的相容性。 只在單一瀏覽器中測試,意味著可能漏掉另一個瀏覽器中的潛在錯誤,讓那些使用者獲得不佳的體驗。有了 Safari MCP 伺服器,你的代理可以在 Safari 中開啟你的網站、檢查計算樣式、確認版面配置,並與你預期的結果比對,而無須切換視窗。

分析效能。 找出網站中拖慢速度的部分。Safari MCP 伺服器讓你的代理能在頁面上執行 JavaScript 以取得效能指標,例如導覽計時與資源載入時間,藉此精確找出拖慢網站的原因並著手正確的修正。

檢查無障礙性。 Safari MCP 伺服器讓你的代理檢查常見的無障礙問題,例如缺少標籤、不當的 ARIA 屬性與不良的對比度,讓你及早發現會影響使用者的問題。

驗證各種使用者狀態。 確認頁面運作與呈現皆符合預期。你的代理可以檢查表單狀態、使用選擇器查詢元素、確認特定互動、展示結帳流程的不同狀態等。減少花在手動檢查上的時間,讓代理替你完成。

這些只是部分使用案例。無論你決定如何實作,Safari MCP 伺服器都能協助你的代理為你做更多事,並減少網頁開發經常需要的來回往返。更順暢的工作流程意味著解決更多錯誤、更快樂的使用者,以及更好的產品。

工具

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

工具說明
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。安裝完成後,請務必啟用網頁開發者功能與遠端自動化。若要為網頁開發者啟用功能,請選擇 Safari > 設定 > 進階 > 勾選「顯示網頁開發者功能」核取方塊。接著前往 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 設定 > 進階 > 顯示網頁開發者功能。接著前往 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 伺服器的代理對話可能的情況:

你:收到一個錯誤回報——航班頁面在 Safari 中有東西壞了。你能查出是怎麼回事嗎?

代理:好的,讓我看看。

代理:我在 Safari 的航班頁面發現兩個不同的錯誤。要我兩個都修嗎?

你:好。這裡還有其他可能對 Safari 使用者造成問題的地方嗎?

代理:有,還有兩件事值得注意。結果顯示動畫在無提示的情況下壞掉了,而且 API 伺服器啟動記錄有誤。要我一併處理嗎?

你只需要一個初始請求就能開始,接著在 Safari MCP 伺服器的協助下,你的代理就能接手處理。

Safari MCP 伺服器完全在你的本機上執行,本身不會發出任何網路呼叫。它也無法存取你在 Safari 中的個人資訊(例如自動填寫或其他瀏覽器活動)。當它擷取頁面內容、螢幕截圖或主控台記錄時,這些資料會直接傳送給你正在執行的代理——而非傳送給 Apple。這些資料之後如何處理,取決於你使用的代理與模型。如同任何你授予瀏覽器存取權的代理,請只使用你信任的代理。

我們為何打造這個工具

打造網頁的方式有很多,無論是否使用 AI。如果 AI 是你工作流程的一部分,我們認為這個工具能讓它更有生產力。如果不是,那也沒關係。

透過打造這項資源,我們希望能讓在 Safari 中測試與除錯變得比以往更簡單,協助你的代理了解事物在瀏覽器中的樣貌與運作方式。

如果你試用了,或者這是你第一次使用 MCP 伺服器,歡迎告訴我們你的想法。請透過 Feedback Assistant 提交問題。

你也可以在網路上找到我們:Saron Yitbarek 在 Bluesky,Jen Simmons 在 Bluesky / Mastodon,以及 Jon Davis 在 Bluesky / Mastodon。