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。