Нативный MCP-сервер Safari для вашего реального, зарегистрированного Safari на macOS. Работает с любым MCP-совместимым клиентом, включая Claude Code, Codex, Cursor, OpenCode и oh-my-pi.

Ваш агент начинается с существующих логинов, файлов cookie и истории. Откройте подписанную страницу и приступайте к работе.

Проверьте свой сайт в Safari. Пусть ваш агент проверяет формы, меню и перетаскивает в браузере, который увидят ваши пользователи Safari.

• Элементы-мишени по UID (снимок), CSS, тексту или координатам. Заполните формы React установщиками, которые обновляют состояние приложения.
• Проверьте, что случилось. Прочитайте консольную и сетевую активность и сохраните скриншоты на диск для просмотра, не заполняя контекст агента данными изображения.
• Запускайте задачи DOM в фоновом режиме. Нативная типизация, нажатия клавиш, зависание и перетаскивание требуют разрешения Safari и Accessibility.

QA на реальных сайтах сформировал инструменты, включая исправления для меню, которые игнорировали клики и зоны падения, которые пропускали файлы.

Построен с помощью Swift и расширения Manifest V3 Safari. Требуется macOS 14+ и Safari 17+. Xcode необходим только для создания исходного кода.

Быстрый старт

###1 Установить

MCPSafari: Your favorite browser, ready for agents

A native Safari MCP server for your real, logged-in Safari on macOS. Works with any MCP-compatible client, including Claude Code, Codex, Cursor, OpenCode, and oh-my-pi.

Your agent starts with your existing logins, cookies, and history. Open a signed-in page and get to work.

• Test your site in Safari. Let your agent check forms, menus, and drag-and-drop in the browser your Safari users will see.
• Target elements by UID (from a snapshot), CSS, text, or coordinates. Fill React forms with setters that update application state.
• Check what happened. Read console and network activity, and save screenshots to disk for review without filling the agent’s context with image data.
• Run DOM tasks in the background. Native typing, key presses, hover, and drag need Safari in front and Accessibility permission.

QA on real sites has shaped the tools, including fixes for menus that ignored clicks and drop zones that missed files.

Built with Swift and a Manifest V3 Safari extension. Requires macOS 14+ and Safari 17+. Xcode is only needed to build from source.

Quick start

1. Install

brew trust epistates/tap
brew install --cask epistates/tap/mcp-safari

brew trust is needed once: installing a cask auto-trusts the cask, but not the mcp-safari-server formula it depends on, and without it the install stops at Refusing to load formula epistates/tap/mcp-safari-server from untrusted tap.

Open MCPSafari.app once so Safari picks up the extension, then enable MCPSafari Extension in Safari → Settings → Extensions. Grant access to the sites you want your agent to use.

Homebrew installs the published release. This README and the tool reference describe main, which may include unreleased features. Check Releases for your version.

2. Connect your client

For Claude Code:

claude mcp add --scope user mcp-safari mcp-safari

For Codex CLI:

codex mcp add mcp-safari -- mcp-safari

Start a new client session after adding the server. For Claude Desktop, Cursor, and other clients, see client configuration.

3. Try it

Ask your agent:

Open example.com in a new Safari tab, read the page heading, and take a screenshot.

The heading should be “Example Domain”. If the connection fails, see troubleshooting. On versions that include it, mcp-safari doctor checks the installation without changing it.

Before you use it