Safari MCP Server

🚀 Safari MCP Server

このModel Context Protocol (MCP)サーバーは、AIアシスタントにSafariブラウザーの自動化と開発者ツールへのアクセスを提供します。LLMがSafariと対話し、コンソールログにアクセスし、ネットワークアクティビティを監視し、ブラウザーの自動化タスクを実行できるようになります。

✨ 主な機能

• 🚀 Safariブラウザーの自動化：Safariセッションの開始、制御、管理
• 🔍 開発者ツールへのアクセス：コンソールログ、ネットワークログ、パフォーマンスメトリクスの取得
• 📸 スクリーンショット：ページのスクリーンショットを撮影し、視覚的な分析を行う
• 🕵️ 要素の検査：DOM要素とそのプロパティの検査
• ⚡ JavaScriptの実行：ブラウザーコンテキストでカスタムJavaScriptを実行する
• 📊 パフォーマンスの監視：タイミングメトリクスとパフォーマンスデータへのアクセス
• 🔧 複数のセッション：複数のSafari自動化セッションを管理する

📦 インストール

前提条件

システム要件

• macOSのみ（SafariとSafariDriverはmacOSでのみ利用可能）
• Node.js 18以上
• Safari 10以上（組み込みのWebDriverサポート付き）

Safariの設定

このMCPサーバーを使用する前に、Safariの自動化機能を有効にする必要があります。

1. 開発者メニューを有効にする：

   • Safariを開き → 環境設定 → 詳細
   • "メニューバーに開発メニューを表示"にチェックを入れる

2. リモート自動化を有効にする：

   • Safariのメニューバーで：開発 → リモート自動化を許可

3. SafariDriverを承認する：

   sudo safaridriver --enable
   

   必要に応じて管理者パスワードを入力します。

インストール手順

1. プロジェクトディレクトリをクローンまたは移動する：

   cd C:\Users\<USERNAME>\RiderProjects\AIPacketAnalyzer\safari-mcp-server
   

2. 依存関係をインストールする：

   npm install
   

3. プロジェクトをビルドする：

   npm run build
   

💻 使用例

サーバーの起動

npm start

サーバーが起動し、標準入出力でMCPプロトコルメッセージを待機します。

開発モード

npm run dev

利用可能なツール

セッション管理

• safari_start_session - 新しいSafari自動化セッションを開始する
• safari_close_session - Safariセッションを閉じる
• safari_list_sessions - すべてのアクティブなセッションをリストする

ナビゲーションとページ情報

• safari_navigate - URLに移動する
• safari_get_page_info - 現在のページのURLとタイトルを取得する

開発者ツールへのアクセス

• safari_get_console_logs - ブラウザーのコンソールログを取得する
• safari_get_network_logs - ネットワークアクティビティログを取得する
• safari_get_performance_metrics - ページのパフォーマンスメトリクスを取得する

ブラウザーの操作

• safari_execute_script - ブラウザーでJavaScriptを実行する
• safari_take_screenshot - ページのスクリーンショットを撮影する
• safari_inspect_element - DOM要素を検査する

Claude Desktopでの使用例

Claude Desktopの設定ファイルに以下の設定を追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "safari-devtools": {
      "command": "node",
      "args": ["C:/Users/<USERNAME>/RiderProjects/AIPacketAnalyzer/safari-mcp-server/build/index.js"]
    }
  }
}

コマンドの例

Claude DesktopのようなMCPクライアントに接続した後、以下のようなコマンドを使用できます。

IDが「main」のSafariセッションを開始し、Googleに移動する：
- セッションを開始する：sessionIdが「main」のsafari_start_session
- 移動する：「https://www.google.com」へのsafari_navigate
- スクリーンショットを撮影する：safari_take_screenshot
- コンソールログを取得する：safari_get_console_logs

📚 ドキュメント

設定オプション

セッションを開始するときに、オプションを指定できます。

{
  "sessionId": "my-session",
  "options": {
    "enableInspection": true,     // Webインスペクターを有効にする
    "enableProfiling": true,      // タイムラインプロファイリングを有効にする
    "usesTechnologyPreview": false // Safari Technology Previewを使用する
  }
}

制限事項

1. 単一セッション制限：Safariは一度に1つのWebDriverセッションのみを許可します
2. macOSのみ：このサーバーはmacOSシステムでのみ動作します
3. Safari固有：Chrome DevTools Protocolとは異なり、SafariのデバッグAPIへのアクセスは制限されています
4. ネットワークログ：ネットワークロギングはSafariのパフォーマンスログに依存しており、制限がある場合があります

開発

プロジェクト構造

safari-mcp-server/
├── src/
│   ├── index.ts                 # メインエントリーポイント
│   ├── safari-mcp-server.ts    # MCPサーバーの実装
│   ├── safari-driver.ts        # Safari WebDriverマネージャー
│   └── types.ts                # TypeScriptの型定義
├── build/                      # コンパイルされたJavaScript
├── package.json
├── tsconfig.json
└── README.md

ビルド

npm run build

変更の監視

npm run watch

ビルドのクリーニング

npm run clean

トラブルシューティング

一般的な問題

1. 「セッションが見つかりません」エラー：

   • 他のコマンドを使用する前にセッションを開始していることを確認してください
   • Safariが予期せずクラッシュまたは閉じていないことを確認してください

2. 「リモート自動化が有効になっていません」：

   • Safariの開発者メニューが有効になっていることを確認してください
   • 開発メニューで「リモート自動化を許可」が有効になっていることを確認してください

3. 権限エラー：

   • sudo safaridriver --enableを実行し、パスワードを入力します
   • ターミナルに必要な権限があることを確認してください

4. Safariが応答しない：

   • 一度にアクティブなSafari自動化セッションは1つだけです
   • 新しいセッションを開始する前に、既存の自動化セッションを閉じてください

デバッグモード

詳細なログを表示するには、サーバーを変更してより詳細な出力を含めるか、自動化が実行されている間にSafariのWebインスペクターを確認します。

コントリビューション

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. 適用可能な場合はテストを追加する
5. プルリクエストを送信する

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

関連プロジェクト

• Model Context Protocol
• MCP TypeScript SDK
• Selenium WebDriver
• Safari WebDriver Documentation