Safari MCP

chính thức

Máy chủ Safari MCP cho phép tác nhân của bạn biết cách mã của bạn thực sự hiển thị trong trình duyệt bằng cách kết nối nó với một cửa sổ trình duyệt Safari

Bạn có thể làm gì với Safari MCP?

  • Kiểm tra hiển thị trang — Yêu cầu agent của bạn mở một trang web trong Safari và kiểm tra computed styles, bố cục và nội dung trang.
  • Gỡ lỗi console và hoạt động mạng — Truy xuất nhật ký console được đệm và liệt kê hoặc kiểm tra các yêu cầu mạng với headers, body và thời gian.
  • Chạy JavaScript và chụp ảnh màn hình — Đánh giá JavaScript trong trang để hiển thị các chỉ số hiệu suất, hoặc chụp ảnh màn hình PNG.
  • Kiểm thử tương tác và trạng thái người dùng — Thực hiện chuỗi click, type, scroll, hover và keyPress để xác minh biểu mẫu và luồng thanh toán.
  • Kiểm tra khả năng truy cập — Yêu cầu agent của bạn tìm các nhãn bị thiếu, thuộc tính ARIA không đúng và độ tương phản kém.
  • Mô phỏng viewport và media — Đặt kích thước viewport theo CSS pixel hoặc mô phỏng một loại media như print để kiểm thử responsive.

Tài liệu

Cập nhật: Trong Safari 27 và Safari Technology Preview 247, chúng tôi giới thiệu máy chủ Safari MCP — một máy chủ Model Context Protocol dành cho các nhà phát triển web, giúp quy trình phát triển và gỡ lỗi web của bạn nhanh hơn và mạnh mẽ hơn. Chúng tôi biết rằng các tác nhân (agent) ngày càng trở nên thiết yếu trong quá trình viết mã, và máy chủ Safari MCP cho phép tác nhân của bạn biết được mã của bạn thực sự hiển thị như thế nào trong trình duyệt bằng cách kết nối nó với một cửa sổ trình duyệt Safari.

Bất kỳ ứng dụng khách tương thích MCP nào cũng có thể kết nối với máy chủ Safari MCP. Bằng cách kết nối tác nhân của bạn với một cửa sổ trình duyệt Safari, tác nhân của bạn có thể mô phỏng những gì người dùng của bạn trải nghiệm, cung cấp cho nó thông tin cần thiết để gỡ lỗi tự chủ hơn, như quyền truy cập vào DOM, các yêu cầu mạng, ảnh chụp màn hình và đầu ra bảng điều khiển.

Nó tăng tốc quy trình gỡ lỗi của bạn và cho phép bạn ở lại trong sự thoải mái của terminal, nghĩa là ít vòng lặp chuyển đổi cửa sổ và gõ lệnh nhắc để gỡ lỗi mã của bạn hơn.

Các trường hợp sử dụng

Nếu bạn xây dựng cho web, thì bạn biết về điệu nhảy gỡ lỗi. Nó thường diễn ra đại loại như thế này:

Bạn thấy có gì đó sai với trang web của mình trong trình duyệt. Bạn mở bảng điều khiển để truy tìm nó. Bạn nhấp vào tab kiểu dáng. Bạn thấy cái gì bị hỏng. Bạn quay lại mã của mình để sửa nó. Hoặc có thể bạn chụp ảnh màn hình, mô tả chi tiết vấn đề cho tác nhân của mình và để nó sửa giúp bạn. Hy vọng là nó làm đúng, lỗi được sửa và bạn có thể tiếp tục.

Nhưng khi nó không được sửa, bạn lại đi qua quy trình một lần nữa — Trình duyệt. Lệnh nhắc. Tác nhân.

Và lặp đi lặp lại, cho đến khi bạn cuối cùng dẹp được lỗi.

Bất kể trình duyệt hay công cụ bạn dùng, quy trình gỡ lỗi là rất nhiều cú nhấp, công cụ và chuyển đổi cửa sổ để thực hiện một bản sửa duy nhất, nhưng không nhất thiết phải như vậy. Nếu bạn đã sử dụng tác nhân trong quy trình phát triển của mình, máy chủ Safari MCP giúp việc gỡ lỗi của bạn nhanh hơn và hiệu quả hơn.

Máy chủ Safari MCP cho phép tác nhân của bạn tự thực hiện nhiều việc gỡ lỗi và khắc phục sự cố hơn. Dưới đây chỉ là một vài ví dụ về những gì nó có thể hỗ trợ:

Phát triển web trong Safari. Lần tới khi bạn phát triển trong Safari, bạn sẽ được hưởng lợi từ một quy trình được nâng cấp. Tác nhân của bạn đã giúp bạn với mã của mình, giờ nó có thể làm nhiều hơn nữa bằng cách kiểm tra xem mã của bạn thực sự hiển thị như thế nào trong Safari.

Cải thiện khả năng tương thích với Safari. Chỉ kiểm thử trong một trình duyệt nghĩa là bỏ lỡ các lỗi tiềm ẩn trong trình duyệt khác, khiến những người dùng đó có trải nghiệm kém hơn. Với máy chủ Safari MCP, tác nhân của bạn có thể mở trang web của bạn trong Safari, kiểm tra các kiểu được tính toán, kiểm tra bố cục và so sánh với những gì bạn mong đợi mà không cần chuyển đổi cửa sổ.

Phân tích hiệu năng. Xem phần nào của trang web đang làm chậm mọi thứ. Máy chủ Safari MCP cho phép tác nhân của bạn đánh giá JavaScript trên trang để làm nổi bật các chỉ số hiệu năng, như thời gian điều hướng và thời gian tải tài nguyên, để nó có thể xác định chính xác điều gì đang làm chậm trang web của bạn và tìm ra cách sửa đúng.

Kiểm tra khả năng truy cập. Máy chủ Safari MCP cho phép tác nhân của bạn kiểm tra các vấn đề truy cập phổ biến như thiếu nhãn, thuộc tính ARIA không đúng và độ tương phản kém, để bạn có thể phát hiện các vấn đề ảnh hưởng đến người dùng của mình.

Xác minh bất kỳ trạng thái người dùng nào. Biết rằng trang đang hoạt động và hiển thị như mong đợi. Tác nhân của bạn có thể kiểm tra trạng thái của biểu mẫu, truy vấn một phần tử bằng bộ chọn, xác nhận các tương tác cụ thể, hiển thị các trạng thái khác nhau của quy trình thanh toán, v.v. Dành ít thời gian hơn cho các kiểm tra thủ công này và trao quyền cho tác nhân làm việc đó thay bạn.

Đây chỉ là một vài trường hợp sử dụng. Dù bạn quyết định triển khai nó như thế nào, máy chủ Safari MCP giúp tác nhân của bạn làm nhiều hơn cho bạn và giảm bớt tất cả sự qua lại mà phát triển web thường đòi hỏi. Một quy trình dễ dàng hơn nghĩa là nhiều lỗi được dẹp hơn, người dùng hạnh phúc hơn và một sản phẩm tốt hơn.

Các công cụ

Dưới đây là các công cụ có sẵn và những gì chúng làm:

Công cụMô tả
browser_console_messagesTrả về nhật ký bảng điều khiển được đệm cho tab hiện tại hoặc được chỉ định
browser_dialogsLiệt kê và phản hồi các hộp thoại trình duyệt (chấp nhận, bỏ qua hoặc nhập văn bản cho lệnh nhắc JS)
close_tabĐóng một tab trình duyệt bằng handle của nó
create_tabTạo một tab trình duyệt mới, tùy chọn tải một URL
evaluate_javascriptThực thi mã JavaScript trong trang và trả về kết quả
get_network_requestLấy chi tiết đầy đủ cho một yêu cầu mạng đã ghi (tiêu đề, nội dung, thời gian)
get_page_contentTrích xuất nội dung văn bản của một trang ở nhiều định dạng khác nhau (markdown, HTML, JSON, v.v.)
list_network_requestsLiệt kê tóm tắt các yêu cầu mạng (URL, phương thức, trạng thái, thời gian) cho tab hiện tại
list_tabsLiệt kê tất cả các tab trình duyệt đang mở với handle và URL của chúng
navigate_to_urlĐiều hướng đến một URL và trả về nội dung của trang đã tải
page_infoLấy thông tin về trang hiện tại: URL, tiêu đề và trạng thái tải
page_interactionsThực hiện các tương tác DOM theo trình tự: nhấp, gõ, cuộn, di chuột, nhấn phím, v.v.
screenshotChụp ảnh màn hình của trang hiện tại dưới dạng PNG
set_emulated_mediaMô phỏng một loại phương tiện CSS (ví dụ: "print") để kiểm thử thiết kế đáp ứng
set_viewport_sizeĐặt kích thước khung nhìn của trình duyệt theo pixel CSS
switch_tabChuyển sang một tab trình duyệt khác bằng handle của nó
wait_for_navigationChờ trang hiện tại tải xong; trả về URL và tiêu đề cuối cùng

Với máy chủ Safari MCP, bạn không còn phải viết lệnh nhắc hoàn hảo, mô tả cẩn thận cho tác nhân của mình những gì bạn đang trải nghiệm trong trình duyệt. Bạn có thể trao cho tác nhân của mình khả năng tự tìm hiểu.

Cách bắt đầu

Safari 27

Đầu tiên, bạn sẽ cần cài đặt Safari 27. Sau khi cài đặt, hãy đảm bảo bật các tính năng dành cho nhà phát triển web và tự động hóa từ xa. Để bật các tính năng cho nhà phát triển web, chọn Safari > Settings > Advanced > đánh dấu vào ô Show features for web developers. Sau đó vào Safari > Settings > Developer > đánh dấu vào "Allow remote automation and external agents."

Nếu bạn đang dùng Claude, bạn có thể dùng lệnh sau trong terminal của mình:

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

Nếu bạn đang dùng Codex, bạn có thể dùng lệnh sau trong terminal của mình:

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

Đối với các tác nhân khác, bạn có thể đặt nội dung sau vào tệp mcp.json hoặc config.json của mình.

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

Safari Technology Preview

Đầu tiên, bạn sẽ cần cài đặt Safari Technology Preview. Sau khi cài đặt, hãy đảm bảo bạn bật Safari Settings > Advanced > Show features for web developers. Sau đó vào Safari Settings > Developer > Enable remote automation and external agents.

Nếu bạn đang dùng Claude, bạn có thể dùng lệnh sau trong terminal của mình:

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

Nếu bạn đang dùng Codex, bạn có thể dùng lệnh sau trong terminal của mình:

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

Đối với các tác nhân khác, bạn có thể đặt nội dung sau vào mcp.json hoặc config.json:

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

Lưu ý rằng mặc dù đoạn mã trên đặt tên máy chủ là safari-mcp-stp, bạn có thể đặt tên tùy ý, thậm chí chỉ là safari. Sau khi bạn đã cài đặt máy chủ Safari MCP, hãy thử một trong các lệnh nhắc sau:

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

Mặc dù mỗi tác nhân hoạt động hơi khác nhau, nó không cần phải được yêu cầu rõ ràng sử dụng máy chủ Safari MCP — nó sẽ tự tìm ra. Những lệnh nhắc đơn giản như trên là đủ để khởi động MCP.

Đây là cách một cuộc trò chuyện với tác nhân sử dụng máy chủ Safari MCP có thể diễn ra:

Bạn: Có báo cáo lỗi — có gì đó bị hỏng trong Safari trên trang chuyến bay. Bạn có thể tìm ra chuyện gì đang xảy ra không?

Tác nhân: Chắc chắn rồi, để tôi xem.

Tác nhân: Tôi tìm thấy hai lỗi riêng biệt trên trang chuyến bay trong Safari. Bạn có muốn tôi sửa cả hai không?

Bạn: Có. Còn gì khác ở đây có thể gây vấn đề cho người dùng Safari không?

Tác nhân: Có, còn hai điều nữa đáng lưu ý. Hoạt ảnh tiết lộ kết quả bị hỏng một cách âm thầm và nhật ký khởi động máy chủ API bị sai. Tôi có nên xử lý cả hai luôn không?

Tất cả những gì bạn cần là một yêu cầu ban đầu để bắt đầu, và với sự trợ giúp của máy chủ Safari MCP, tác nhân của bạn có thể tiếp tục từ đó.

Máy chủ Safari MCP chạy hoàn toàn trên máy cục bộ của bạn và không thực hiện bất kỳ cuộc gọi mạng nào của riêng nó. Nó cũng không có quyền truy cập vào thông tin cá nhân của bạn trong Safari (ví dụ: AutoFill hoặc hoạt động trình duyệt khác). Khi nó ghi lại nội dung trang, ảnh chụp màn hình hoặc nhật ký bảng điều khiển, dữ liệu đó đi trực tiếp đến tác nhân bạn đang chạy — không đến Apple. Điều gì xảy ra với dữ liệu đó từ đó phụ thuộc vào tác nhân và mô hình bạn đang sử dụng. Như với bất kỳ tác nhân nào bạn cấp quyền truy cập vào trình duyệt của mình, chỉ sử dụng những cái bạn tin tưởng.

Tại sao chúng tôi xây dựng điều này

Có nhiều cách để xây dựng cho web, cả có và không có AI. Nếu AI là một phần trong quy trình của bạn, chúng tôi nghĩ công cụ này sẽ giúp nó hiệu quả hơn nữa. Và nếu không, điều đó cũng không sao.

Bằng cách tạo ra tài nguyên này, chúng tôi hy vọng sẽ giúp việc kiểm thử và gỡ lỗi trong Safari trở nên dễ dàng hơn bao giờ hết bằng cách giúp tác nhân của bạn hiểu mọi thứ trông và hoạt động như thế nào trong trình duyệt.

Nếu bạn dùng thử hoặc nếu đây là lần đầu tiên bạn sử dụng máy chủ MCP, hãy cho chúng tôi biết ý kiến của bạn. Gửi vấn đề qua Feedback Assistant.

Ngoài ra bạn có thể tìm thấy chúng tôi trực tuyến: Saron Yitbarek trên Bluesky, Jen Simmons trên Bluesky / Mastodon, và Jon Davis trên Bluesky / Mastodon.