MacOS에서 로그인한 Safari MCP 서버. Claude Code, Codex, Cursor, OpenCode 및 oh-my-pi를 포함한 모든 MCP 호환 클라이언트와 함께 작동합니다.

귀하의 에이전트는 기존 로그인, 쿠키, 역사와 함께 시작합니다. 로그인 페이지를 열고 작업합니다.

• Safari에서 사이트를 테스트합니다. 귀하의 에이전트 확인 양식, 메뉴, 그리고 Safari 사용자의 브라우저에서 드래그 앤 드롭을 볼 수 있습니다.
• UID ( 스냅샷에서), CSS, 텍스트 또는 좌표로 대상 요소. Application state를 업데이트하는 setters와 React 양식을 작성합니다.
• 무슨 일이 있었는지 확인하십시오. 콘솔 및 네트워크 활동을 읽고 스크린 샷을 디스크에 저장하여 에이전트의 텍스트 데이터를 작성하지 않고 검토합니다.
• 배경에서 DOM 작업을 실행합니다. 네이티브 타이핑, 키 프레스, 호버, 그리고 프론트 및 Accessibility 권한에서 Safari를 드래그해야합니다.

실제 사이트의 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