Safari MCP

🦁 Safari MCP

コーディングエージェントのためのブラウザーです。

ログイン済みの実際の Safari — Chrome も、発熱も、ヘッドレスも不要です。

VS Code にインストール · VS Code Insiders · Cursor にインストール

98 個のツール · Chrome／Puppeteer／Playwright は不要 · コマンドあたり約 5ms · Chrome より CPU 使用率を 60% 削減

クイックスタート · 98 個すべてのツール · 使用例 · Safari MCP を選ぶ理由 · アーキテクチャ · 変更履歴

❌ Safari MCP がない場合

AI エージェントがブラウザーを使う必要がある場合、次のいずれかになります。

• Playwright で Chromium を起動する — ログイン情報も Cookie もセッションもありません
• Chrome DevTools MCP を使う — 2 つ目のブラウザーを動かしてファンをフル回転させます
• ヘッドレススクレイパーに頼る — Cloudflare、reCAPTCHA、ボット検知によってブロックされます

✅ Safari MCP がある場合

AI が操作するのは、すでにログインしている Safariです — Gmail、GitHub、Ahrefs、Slack、銀行など。

ネイティブ WebKit。CPU 使用率を約 60% 削減。バックグラウンド動作。98 個のツール。npx コマンド 1 つ。macOS 専用です。

📰 freeCodeCamp に掲載： macOS で AI コーディングエージェントをブラウザーに接続する方法 · HackerNoon：React、Shadow DOM、CSP のリバースエンジニアリング

🍎 Apple が公式の Safari MCP をリリースしました — safaridriver --mcp は Safari Technology Preview 247（2026 年 7 月）で初登場し、Safari 27.0 以降の安定版にも搭載されています。これはデバッグ用に分離された自動化セッションを操作します。safari-mcp が操作するのは、すでにログインしている実際の Safariです — Cookie とセッションをそのまま使い、バックグラウンドで 98 個のツールを利用できます。詳しい比較は以下をご覧ください。

主な特長

• 98 個のツール — ナビゲーション、クリック、フォーム、スクリーンショット、ネットワーク、ストレージ、アクセシビリティなど
• 発熱ゼロ — Apple Silicon 上のネイティブ WebKit を使用し、Chrome より CPU 使用率を約 60% 削減
• 実際のブラウザーを使用 — すべてのログイン情報、Cookie、セッションを保持します（Gmail、GitHub、Ahrefs など）
• バックグラウンド動作 — Safari はバックグラウンドで動作し、ウィンドウを奪いません
• ブラウザー依存関係なし — Puppeteer、Playwright、WebDriver、Chrome は不要
• プロセスを維持 — 1 つの osascript プロセスを再利用します（コマンドあたり約 5ms、通常は約 80ms）
• フレームワークに対応 — ネイティブセッターによる React、Vue、Angular、Svelte のフォーム入力

ユーザー自身の言葉

依頼して集めた推薦文ではありません。公開されているイシュートラッカーから引用し、それぞれ引用元のスレッドにリンクしています。

「通常のSafariプロファイルに対して、複数のPiセッション／サブエージェントを並行して実行しています。Cookieとログイン情報を共有するのは意図的です。」 — @maxim、実際のブラウザーに対して並行してエージェントを実行することについて

「このサーバーには意図的なタブ所有権モデルがあります……この点はコードで慎重に扱われており、デフォルトのケースでは適切な安全対策です。」 — @turner-moore、タブに触れないようガードが拒否する理由について

「パッケージから直接ローカルで検証しました。Safari MCP doctor 6/6。」 — @jrepp、フォーカスヘルパーのキュー整列のバグを見つけて修正した方

クイックスタート

前提条件

• Safariが動作するバージョンのmacOS
• Node.js 20+
• Safari → 設定 → 詳細 → Webデベロッパー向けの機能を表示 ✓
• Safari → 設定 → デベロッパー → Apple EventsからのJavaScriptを許可 ✓

インストール（コマンド1つ）

npx safari-mcp

これで完了です。グローバルインストールは不要です。または、恒久的にインストールするには：

npm install -g safari-mcp

MCPクライアントを設定する

すべてのクライアントでSafari MCPの実行方法は同じです。npx safari-mcpを使います。エディターを選択してください。

claude mcp add safari -- npx safari-mcp

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "servers": {
    "safari": {
      "type": "stdio",
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

mcpServers:
  - name: safari
    command: npx
    args:
      - safari-mcp

extensions:
  safari:
    name: safari
    type: stdio
    cmd: npx
    args:
      - safari-mcp
    enabled: true

{
  "context_servers": {
    "safari": {
      "command": {
        "path": "npx",
        "args": ["safari-mcp"]
      }
    }
  }
}

brew install achiya-automation/tap/safari-mcp

git clone https://github.com/achiya-automation/safari-mcp.git
cd safari-mcp && npm install

使用ワークフロー

Safari MCPを使うAIエージェントに推奨されるパターン：

1. safari_snapshot        → Get page state (accessibility tree)
2. safari_click/fill/...  → Interact with elements by ref
3. safari_snapshot        → Verify the result

要素のターゲティング — ツールでは複数のターゲティング方法を利用できます。

ヒント： まずsafari_snapshotを使って要素のrefを取得し、正確なターゲティングにはrefを使ってください。CSSセレクターより高速で信頼性も高くなります。

複数のエージェントを同時に実行する

複数のエージェントまたはサブエージェントが同時に1つの Safari を操作すると、アクティブなタブの制御を奪い合います。クライアントごとに1つのプロセスを実行するのではなく、共有 HTTP デーモンに接続すれば、この問題を回避できます。

SAFARI_MCP_HTTP=1 SAFARI_MCP_HTTP_PORT=9225 npx safari-mcp

次に、すべてのクライアントをそのデーモンに接続します。

{ "mcpServers": { "safari-mcp": { "type": "http", "url": "http://127.0.0.1:9225/mcp" } } }

1つのデーモンで複数のセッションを実行できます。各セッションは独自のタブ状態を持ちます。サーバーは MCP セッション ID を基に、activeTabIndex、所有権フラグ、固有のタブマーカーを管理するため、セッション A がセッション B のタブを読み取ったり操作したりすることは物理的に不可能です。

単に整然としているだけでなく、安全性を確保しているのは次の2つの性質です。

• タブの識別にはインデックスではなくマーカーを使います。 各セッションは、開いたページに固有の ID を記録するため、ページ遷移後も、ユーザーがほかのタブの順序を入れ替えたり閉じたりした後も、所有権が維持されます。インデックスだけでは、気付かないうちに別のタブを操作してしまいます。

• 安全側に倒して処理を停止します。 セッションのマーカーが付いたタブを再検出できない場合、手前にあるタブへ切り替えるのではなく、すべてのツールが処理を拒否します。手前のタブは、たいていあなたが使っているものだからです。

  Tab tracking lost — refusing to fall back to "current tab of window"
  (would target the user's active tab). Call safari_new_tab to reopen.
  

これにより、プロセス数も大幅に削減されます。17の同時セッションで約17個の node プロセスが必要だったところ、1個で済みます。

SAFARI_PROFILE は任意の設定です。設定しなければ、通常の Safari ウィンドウ、Cookie、ログイン状態を維持したままセッションが接続されます。詳しくは docs/http-transport-design.md をご覧ください。

永続デーモンよりも stdio（エージェントごとに1プロセス）を使いたい場合も、それで問題ありません。その場合、分離はプロセス境界そのものによって実現されます。ただし、クライアントが mcporter を介して複数のエージェントを多重化する場合は注意が必要です。mcporter は、どのトランスポートを選んでも、すべてのエージェントで1つの MCP クライアントをキャッシュします。そのため、サーバーは個別のセッションを認識できず、セッションごとの分離が機能しません。#76 をきっかけに @maxim が作成した pi 拡張機能の mcporter-lanes は、この問題を上流で解決します。各エージェントセッションに独自のデーモンディレクトリ、ひいては独自の safari-mcp を割り当て、アイドルタイムアウトによってプロセスが増え続けないようにします。

すでに開いているタブを操作する

デフォルトでは、サーバーは自分で開いたタブだけを操作します。自分が開いたタブを指定しても、操作を拒否します。

Tab safety: refusing "click" — current tab (https://mail.example.com/inbox) was not
opened by this MCP session. Use safari_new_tab or safari_switch_tab to target your own tab.

このデフォルト設定があるのは、初期バージョンがユーザーのタブをクリックして開いたり、閉じたりしていたためです。しかし、「今見ている記事を読んで」や「画面に表示されているフォームに入力して」といった操作は実際に必要です。また、ページを開き直すと、そのタブを使う価値を高めていたセッション状態が失われます。SAFARI_MCP_ALLOW_USER_TABS=1 を設定すると、明示的に safari_switch_tab を呼び出した場合、タブを拒否する代わりにセッションが引き継ぎます。それ以降、そのセッションは自分で開いたタブと同じようにそのタブを操作し、引き継いだことも通知します。

{ "tabIndex": 3, "safeUrl": "https://mail.example.com/inbox", "note": "(user tab, opted-in)" }

このフラグを設定しても、意図的に次の動作は変わりません。

• 引き継ぎを許可しますが、ガードは解除しません。 引き継ぎを行うのは safari_switch_tab だけで、対象も指定したタブだけです。通常のクリックやページ遷移では、たまたま手前にあるタブへ切り替わることはありません。サーバーは、あなたが移動した先ではなく、あなたが指定したタブを操作します。
• safari_close_tab は引き続き拒否されます。 閉じる操作だけは取り消せないため、引き継いだタブは操作できますが、破棄することはできません。閉じる場合は自分で操作してください。
• 引き継ぎはセッション内に限られます。 共有の所有権ファイルには何も書き込まれないため、引き継ぎ状態は次のプロセスに漏れることなく、セッションの終了とともに解除されます。

safari_doctor にはフラグの状態が表示され、引き継いだタブに対するすべての操作で (user tab, opted-in) がログに記録されます。そのため、「なぜ自分のタブを操作したのか」という疑問にも、謎ではなく理由を確認できます。デフォルトではオフです。自分のブラウジングセッション内で作業させたいエージェントにのみ設定してください。#92 で設計されました。

環境変数

SAFARI_MCP_RAISE_ON_NAVIGATE=1 は、ページを表示することが主な目的のエージェント向けです。たとえば、「YouTube を開いて」と答える音声アシスタントや、デモを操作するエージェントです。それ以外ではオフにしてください。デフォルトでは Safari MCP はバックグラウンドで動作し、フォーカスを使用中のアプリに戻すため、別の場所で入力を続けながらエージェントにページを操作させることができます。

ツール（98 個）

セキュリティ

Safari MCP は攻撃対象領域を最小限に抑え、Mac 上でローカルに動作します。

Safari MCP と代替ツールの比較

ヒント： 日常的なブラウジング作業（業務の95％）には Safari MCP を使い、Lighthouse／パフォーマンス監査にのみ Chrome DevTools MCP を使ってください。

Apple 公式 Safari MCP（safaridriver）との比較

2026年7月、Apple は safaridriver をベースにした公式 Safari MCP サーバーをリリースしました。最初に Safari Technology Preview 247 で公開され、その後、安定版 Safari 27.0 以降にも搭載されています。これはこのカテゴリの有効性を示す素晴らしい例ですが、別の用途向けに作られています。Apple のサーバーはデバッグ用に隔離された WebDriver 自動化セッションを操作しますが、safari-mcp は、すでにログインしている実際の Safariを操作します。

macOS 27.0 と Safari 27.0 では、safaridriver --help に --mcp が表示され、tools/list の応答には17項目が含まれます（2026-09-15 に確認）。Safari 26.5.2 には --mcp がありませんでした（2026-07-23 に確認）。お使いのマシンで safaridriver --help | grep mcp を実行して確認してください。

両方を実行しますか？ Apple のセットアップガイドでは、サーバーを safari-mcp という名前で登録しています（claude mcp add safari-mcp -- /usr/bin/safaridriver --mcp）。これはこのパッケージと同じ名前です。クライアントがどちらか一方をもう一方で上書きしたり、どちらのサーバーが応答したのか分からなくなったりしないよう、claude mcp add safari-webdriver -- /usr/bin/safaridriver --mcp のように、どちらかに別の名前を付けてください。

navigator.webdriver の項目について： WebDriver 標準では、リモート制御されるすべてのセッションが true を返す必要があるため、Apple のサーバーもそうなります。safari-mcp は通常のタブで JavaScript を評価するため、false を読み取ります（Safari 27.0、2026-09-17 に確認）。Web サイトが WebDriver の通信を拒否する場合、これが違いになります。これは検出回避機能ではありません。ブラウザーのそれ以外の情報は隠されず、実際のログイン情報を使用するため、すべてのページがあなたの正確な身元を把握していると考えてください。

Apple のサーバーが適している場合： Safari 27 以降での互換性デバッグのために、WebDriver 標準に準拠したクリーンルームのセッションが必要な場合です。それ以外すべての用途、つまり、すでにログインしているブラウザーをバックグラウンドで日常的に自動化する用途には、safari-mcp がまさにそのために作られています。

なぜ他の Safari MCP プロジェクトではなく、Safari MCP なのか？

「safari-mcp」と呼ばれるプロジェクトはいくつかあります。それぞれを比較してみましょう。

要約 — インストールが最もスムーズで、ツールが最も充実し、積極的にメンテナンスされている完全版 Safari MCP をお探しなら、これが最適です。

アーキテクチャ

Safari MCP はデュアルエンジンアーキテクチャを採用しています。速度と高度な機能を優先して拡張機能を使用し、いつでも利用できるフォールバックとして AppleScript を備えています。

Claude/Cursor/AI Agent
        ↓ MCP Protocol (stdio)
   Safari MCP Server (Node.js)
        ↓                    ↓
   Extension (HTTP)     AppleScript + Swift daemon
   (~5-20ms/cmd)        (~5ms/cmd, always available)
        ↓                    ↓
   Content Script       do JavaScript in tab N
        ↓                    ↓
   Page DOM ←←←←←←←←←← Page DOM

主な設計上の判断：

• 自動フォールバック付きのデュアルエンジン — 拡張機能を優先し、接続されていない場合は AppleScript がすべてをシームレスに処理します
• 永続的な Swift ヘルパー — コマンドごとにプロセスを起動する代わりに、1 つのプロセスを長時間実行します（16 倍高速）
• タブインデックスによる操作 — すべての JS はインデックスで指定した特定のタブ上で実行され、画面上のフォーカスを奪うことはありません
• JS 優先のアプローチ — 入力、クリック、ファイルアップロードはすべて JavaScript イベントを使用します（System Events のキーボード競合を回避）
• activate を使用しない — Safari が前面に表示されることはありません

Safari 拡張機能（任意）

Safari MCP 拡張機能は任意ですが、推奨されます。拡張機能がなくても、機能の約 80% は AppleScript のみで動作します。拡張機能を追加すると、AppleScript では実現できない機能を利用できます。

拡張機能で追加される機能

拡張機能が必要なのはどんなときですか？ 閉じた Shadow DOM を使用する最新の SPA（例：Reddit）、厳格な Content Security Policy を設定したサイト、またはフレームワークを多用するエディター（Draft.js、ProseMirror、Slate）を自動化する場合です。

拡張機能のインストール

この拡張機能を使用するには、Xcode（無料、macOS に付属）で一度ビルドする必要があります。

npm ユーザー向けの注意： xcode/ ディレクトリは npm パッケージに含まれていません。 GitHub リポジトリをクローンして、ソースからビルドしてください。

前提条件： Xcode（App Store からインストール — 無料）

# 1. Clone the repo (the npm package does not include the Xcode project)
git clone https://github.com/achiya-automation/safari-mcp.git
cd safari-mcp

# 2. Build a clean, Apple Development-signed app
# If needed, first choose your Team in Xcode → Signing & Capabilities.
xcodebuild -project "xcode/Safari MCP/Safari MCP.xcodeproj" \
  -scheme "Safari MCP (macOS)" -configuration Release \
  -allowProvisioningUpdates clean build

# 3. Locate the signed app
APP_PATH=$(find ~/Library/Developer/Xcode/DerivedData/Safari_MCP-*/Build/Products/Release -name "Safari MCP.app" -maxdepth 2 | head -1)

# 4. Re-sign safari-helper with the Apple Events entitlement
# (helps macOS surface the TCC Automation prompt reliably).
# Keep the stable identifier: macOS keys the Accessibility grant to it.
codesign --sign - --force --identifier com.achiya-automation.safari-mcp \
  --entitlements safari-helper.entitlements safari-helper

# 5. Open the app (needed once so Safari registers the extension)
open "$APP_PATH"

codesign --deep --sign - を使って Safari MCP.app をアドホック署名し直さないでください。 これにより、ラッパーと埋め込み拡張機能の Apple Development ID が置き換えられます。すると、現在の Safari は拡張機能を無効にしたり、削除済みとしてマークしたりすることがあります。以前のビルドにアドホック署名した場合は、上記の clean build コマンドをもう一度実行してください。

または、xcode/Safari MCP/Safari MCP.xcodeproj を Xcode で直接開き、「Signing & Capabilities」で Apple ID を選択して、「Run」をクリックしてください。ローカルで使用する場合は、無料の個人用 Apple Developer アカウントで十分です。

続いて Safari で次の操作を行います。

1. Safari → 設定 → 詳細 → Web デベロッパ用の機能を表示を有効にする
2. Safari → 設定 → デベロッパ → 署名されていない拡張機能を許可（Safari を再起動するたびに必要）
3. Safari → 設定 → 機能拡張 → Safari MCP Bridgeを有効にする

拡張機能は、自身の Safari プロファイルと一致するプロファイルを宣言している最初のローカルブリッジに自動的に接続します。ブリッジのデフォルトのポートは 9224、9228、9232、9236 です。通常、単一プロファイルの設定では 9224 を使用します。

注意： 「署名されていない拡張機能を許可」の設定は、Safari を再起動するたびにリセットされます。再起動後は毎回、Safari → 設定 → デベロッパで再度有効にしてください。拡張機能自体はインストールされたままです。

ツールバーアイコンの状態：

• ON — MCP サーバーに接続中
• OFF — ポップアップから手動で無効化
• (バッジなし) — サーバーが起動していません。自動的に再接続します

macOS の権限

Safari MCP では、次の権限を一度だけ許可する必要があります。

safari-helper にアクセシビリティ権限を付与する（safari_native_* に必要）

​safari_native_click、safari_native_keyboard、safari_native_hover ツールは、フォーカスを奪うことなく OS レベルの CGEvent イベントを Safari に注入します。これらのイベントを最前面でないウィンドウに送るには、基盤となるヘルパーバイナリを macOS のアクセシビリティで承認する必要があります。

1. システム設定 → プライバシーとセキュリティ → アクセシビリティを開きます（macOS 27 では、このパネルの名称はデバイス制御とデータアクセスです）。
2. + をクリックします（必要に応じてパスワードでロックを解除します）。
3. ヘルパーバイナリに移動して追加します。
   • npm のグローバルインストール：$(npm root -g)/safari-mcp/safari-helper
   • npx ／プロジェクトへのインストール：./node_modules/safari-mcp/safari-helper
   • ソースのクローンから：/path/to/safari-mcp/safari-helper
4. その横の切り替えがONになっていることを確認します。

postinstall スクリプトは、ヘルパーに固定の識別子（com.achiya-automation.safari-mcp）で再署名するため、この権限は今後のアップグレード後も維持されます。この手順を行わない場合、ビルドごとにアドホック署名の識別子が変わるため、npm update のたびに承認が通知なく取り消されます。

safari_native_click が成功を報告するのにページが反応しない場合（isTrusted: true のクリックイベントが発生しない場合）、この承認がヘルパーに付与されていない可能性が最も高いです。safari_*（native_ なし）のツールには、この権限は必要ありません。

Automation → Safari の許可（IDE ユーザー向けの重要事項）

macOS の TCC では、Automation の許可は MCP サーバーを起動する 親プロセス に付与され、safari-mcp 自体には付与されません。そのため、Claude Code／Cursor／Windsurf を実行するアプリ（通常は Visual Studio Code または Terminal）に Automation → Safari の許可を付与する必要があります。

許可ダイアログが自動的に表示されない場合は、Automation の許可をすでに持っている Terminal から、このコマンドを一度実行してください。

osascript -e 'tell application "Safari" to get URL of current tab of window 1'

この呼び出しにより、Terminal アプリが Automation データベースに登録され、Safari の許可を求めるダイアログが表示されます。許可すると、その後は、どの子プロセスの呼び出し元チェーンからの MCP 呼び出しも機能します。

トラブルシューティング

よくある質問

対応クライアント

Safari MCP は、MCP 対応のあらゆるクライアントで動作します。

貢献

プルリクエストを歓迎します！セットアップ手順については、CONTRIBUTING.mdをご覧ください。

コードベースは2つのファイルで構成されています。

• safari.js — Safari 自動化レイヤー（AppleScript + JavaScript）
• index.js — ツール定義を含む MCP サーバー

スポンサー

Safari MCP は無料のオープンソースです。時間や CPU サイクルの節約に役立った場合は、開発へのご支援をご検討ください。

ご支援は、以下に活用されます。

• 🧪 macOS の各バージョンおよび Safari の各リリースでのテスト
• 🛠️ 新しいツールと機能
• 📖 ドキュメントとサンプル

最初のスポンサーになりましょう！

商用サポート

Safari MCP を製品やエージェントスタックに組み込む必要がありますか？ Achiya Automation では、以下を提供しています。

• 優先的なバグ修正と、ユースケースに合わせたカスタムツールの開発
• 統合コンサルティング — Safari MCP を本番環境のエージェントシステム（Claude、Cursor、n8n、カスタムシステム）に組み込む支援
• プライベートデプロイのサポート — マルチユーザーの Safari MCP、標準外の macOS 環境、CI/CD
• MCP ベースの自動化を導入するエンジニアリングチーム向けのトレーニングワークショップ

Safari MCP の作者が開発しました。お問い合わせください →

Safari MCP でエージェントが実現できること

AI エージェントが Safari MCP を操作すると、ヘッドレスブラウザーでは実現できないことが可能になります。

• 認証済みの実セッション — Gmail、GitHub、Ahrefs、Slack、銀行のダッシュボードにはすでにログインしています
• フレームワークを考慮したフォーム入力 — safari_fill_and_submit は React／Vue／Angular のセッターをネイティブに呼び出すため、input イベントが発火したかを推測する必要はありません
• バックグラウンドでの動作 — Mac を使い続けながら、エージェントを並行して動かせます
• ワークフローごとに1回の MCP 呼び出し — safari_run_script は、ナビゲーション、クリック、抽出を1回のラウンドトリップにまとめます

このパターンはモデルを問わず有効です。人間がすでに信頼しているブラウザーを操作することで、ログイン状態、Cookie、拡張機能、ユーザー固有の環境を一度に引き継げます。

コミュニティ

npm の月間ダウンロード数は6,000件以上 — 開発者は Safari MCP を使って macOS 上で AI エージェントを構築しています。

• GitHub Discussions — 質問したり、ユースケースを共有したりできます
• Issues — バグ報告や機能リクエスト
• — 貢献を始めましょう

エコシステム

Safari MCP と連携する、その他の macOS MCP サーバーです。

Safari MCP と Chrome DevTools MCP を併用していますか？Safari は日常的なブラウジングの95％を（オーバーヘッドなしで）処理し、Chrome は Lighthouse や Chrome 固有のトレースが必要な残りの5％を処理します。

掲載先

ライセンス

MIT — お好きなようにお使いください。

Achiya Automation が開発 — ビジネス向けの自動化と AI エージェント。