Safari MCP

公式

Safari MCPサーバーは、エージェントをSafariブラウザウィンドウに接続することで、コードがブラウザで実際にどのようにレンダリングされるかを把握する機能を提供します。

Safari MCPで何ができますか?

  • ページレンダリングの検査 — エージェントにSafariでサイトを開かせ、計算済みスタイル、レイアウト、ページコンテンツを確認させます。
  • コンソールとネットワークアクティビティのデバッグ — バッファされたコンソールログを取得し、ヘッダー、ボディ、タイミングを含むネットワークリクエストを一覧表示または検査します。
  • JavaScriptの実行とスクリーンショットのキャプチャ — ページ内でJavaScriptを評価してパフォーマンス指標を明らかにするか、PNGスクリーンショットをキャプチャします。
  • インタラクションとユーザー状態のテスト — click、type、scroll、hover、keyPressのシーケンスを実行して、フォームやチェックアウトフローを検証します。
  • アクセシビリティの確認 — エージェントに、欠落したラベル、不適切なARIA属性、不十分なコントラストを探させます。
  • ビューポートとメディアのエミュレート — ビューポートサイズをCSSピクセルで設定するか、レスポンシブテスト用にprintなどのメディアタイプをエミュレートします。

ドキュメント

更新: Safari 27 と Safari Technology Preview 247 では、Safari MCP サーバーを導入します。これはウェブ開発者向けの Model Context Protocol サーバーであり、ウェブ開発とデバッグのワークフローをより迅速かつ強力にします。エージェントがコーディングプロセスにおいてますます不可欠になっていることを私たちは認識しており、Safari MCP サーバーはエージェントを Safari ブラウザウィンドウに接続することで、コードがブラウザで実際にどのようにレンダリングされるかをエージェントが把握できるようにします。

MCP 互換のクライアントであれば、どれでも Safari MCP サーバーに接続できます。エージェントを Safari ブラウザウィンドウに接続することで、エージェントはユーザーが体験していることをエミュレートでき、DOM、ネットワークリクエスト、スクリーンショット、コンソール出力へのアクセスなど、より自律的にデバッグするために必要な情報を得られます。

これによりデバッグプロセスが迅速化され、ターミナルの快適な環境に留まることができます。つまり、コードをデバッグするためにウィンドウを行き来したりプロンプトを入力したりする回数が減ります。

ユースケース

ウェブ向けに開発しているなら、あのデバッグのダンスをご存じでしょう。通常は次のような流れになります:

ブラウザでサイトに問題があることに気づきます。コンソールを開いて原因を探します。スタイルタブをクリックします。何が壊れているかを確認します。コードに戻って修正します。あるいは、スクリーンショットを撮り、問題をエージェントに詳しく伝えて、修正を任せるかもしれません。うまくいけば正しく修正され、バグは解消し、先に進めます。

しかし修正されない場合は、同じワークフローを繰り返します — ブラウザ、プロンプト、エージェント。

そしてバグをようやく潰すまで、何度も何度も繰り返します。

使用するブラウザやツールに関係なく、デバッグのワークフローは1つの修正のために多くのクリック、ツール、ウィンドウの行き来を伴いますが、そうである必要はありません。開発ワークフローですでにエージェントを使っているなら、Safari MCP サーバーはデバッグをより迅速かつ効率的にします。

Safari MCP サーバーは、エージェントがより多くのデバッグやトラブルシューティングを自力で行えるようにします。以下は、それが役立つほんのいくつかの例です:

Safari でのウェブ開発。次に Safari で開発するとき、アップグレードされたワークフローの恩恵を受けられます。エージェントはすでにコードの支援をしてくれていますが、今度はコードが Safari で実際にどのようにレンダリングされるかを確認することで、さらに多くのことができます。

Safari との互換性を向上。1つのブラウザだけでテストすると、別のブラウザでの潜在的なバグを見逃し、そのユーザーに質の低い体験を与えてしまいます。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_urlURL に移動し、読み込まれたページのコンテンツを返す
page_info現在のページに関する情報(URL、タイトル、読み込み状態)を取得する
page_interactionsDOM インタラクションを順番に実行する:クリック、入力、スクロール、ホバー、キー押下など
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 のフライトページで2つの異なるバグを見つけました。両方修正しましょうか?

あなた:はい。Safari ユーザーに問題を引き起こしている可能性のあるものは他にありますか?

エージェント:はい、他に2つ指摘すべきことがあります。結果表示のアニメーションがサイレントに壊れており、API サーバーの起動ログが誤っています。これらも両方対応しましょうか?

最初のリクエストだけで始められ、Safari MCP サーバーの助けを借りて、エージェントがそこから進めることができます。

Safari MCP サーバーは完全にローカルマシン上で動作し、独自のネットワーク呼び出しは行いません。また、Safari 内の個人情報(AutoFill やその他のブラウザアクティビティなど)にもアクセスできません。ページコンテンツ、スクリーンショット、コンソールログをキャプチャするとき、そのデータは実行中のエージェントに直接送られ、Apple には送られません。その後のデータの扱いは、使用しているエージェントとモデルによって異なります。ブラウザへのアクセスを許可するエージェントは、信頼できるものだけを使用してください。

これを開発した理由

ウェブ向けに開発する方法は、AI を使う場合も使わない場合も数多くあります。AI がワークフローの一部であるなら、このツールがさらに生産性を高めるのに役立つと考えています。そうでない場合も、それで問題ありません。

このリソースを作成することで、エージェントがブラウザで物事がどのように見え、機能するかを理解できるようにし、Safari でのテストとデバッグをこれまで以上に簡単にしたいと考えています。

試してみた場合や、MCP サーバーを初めて使う場合は、ご意見をお聞かせください。フィードバックアシスタントから問題を報告してください。

また、オンラインでも見つけられます:Saron Yitbarek は Bluesky、Jen Simmons は Bluesky / Mastodon、Jon Davis は Bluesky / Mastodon にいます。