Safari MCP
официальныйСервер Safari MCP предоставляет вашему агенту возможность видеть, как ваш код на самом деле отображается в браузере, подключая его к окну браузера Safari.
Что можно делать с Safari MCP?
- Проверка рендеринга страницы — Попросите вашего агента открыть сайт в Safari и проверить вычисленные стили, макет и содержимое страницы.
- Отладка консоли и сетевой активности — Получайте буферизованные логи консоли и просматривайте или инспектируйте сетевые запросы с заголовками, телом и таймингами.
- Запуск JavaScript и создание скриншотов — Выполняйте JavaScript на странице для получения метрик производительности или делайте PNG-скриншот.
- Тестирование взаимодействий и состояния пользователя — Выполняйте последовательности click, type, scroll, hover и keyPress для проверки форм и сценариев оформления заказа.
- Проверка доступности — Попросите вашего агента искать отсутствующие метки, неправильные атрибуты ARIA и плохой контраст.
- Эмуляция viewport и медиа — Задавайте размер viewport в 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 (например, к AutoFill или другой активности браузера). Когда он захватывает содержимое страницы, скриншоты или логи консоли, эти данные направляются напрямую агенту, которого вы запускаете, — а не Apple. Что происходит с этими данными дальше, зависит от агента и модели, которые вы используете. Как и с любым агентом, которому вы даёте доступ к своему браузеру, используйте только те, которым доверяете.
Почему мы это создали
Есть много способов создавать для веба — как с ИИ, так и без него. Если ИИ является частью вашего рабочего процесса, мы думаем, что этот инструмент поможет сделать его ещё более продуктивным. А если нет — это тоже нормально.
Создавая этот ресурс, мы надеемся сделать тестирование и отладку в Safari проще, чем когда-либо, помогая вашему агенту понимать, как всё выглядит и работает в браузере.
Если вы попробуете его или если это ваш первый опыт использования сервера MCP, дайте нам знать, что вы думаете. Сообщайте о проблемах через Feedback Assistant.
Также вы можете найти нас в сети: Сарон Итбарек в Bluesky, Джен Симмонс в Bluesky / Mastodon, и Джон Дэвис в Bluesky / Mastodon.