Safari MCP Server

🚀 Safari MCP Server

Safari MCP Server 是一個模型上下文協議（MCP）服務器，它為 AI 助手提供 Safari 瀏覽器自動化功能以及對開發者工具的訪問權限。該服務器使大語言模型（LLMs）能夠與 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：
- 啟動會話：safari_start_session 並指定 sessionId 為 "main"。
- 導航：safari_navigate 到 "https://www.google.com"。
- 截圖：safari_take_screenshot。
- 獲取控制檯日誌：safari_get_console_logs。

📚 詳細文檔

配置選項

啟動會話時，你可以指定選項：

{
  "sessionId": "my-session",
  "options": {
    "enableInspection": true,     // 啟用 Web 檢查器
    "enableProfiling": true,      // 啟用時間線分析
    "usesTechnologyPreview": false // 使用 Safari 技術預覽版
  }
}

限制

1. 單會話限制：Safari 一次只允許一個 WebDriver 會話。
2. 僅支持 macOS：此服務器僅在 macOS 系統上運行。
3. Safari 特定：與 Chrome DevTools 協議不同，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 一次只能有一個自動化會話處於活動狀態。
   • 在啟動新會話之前關閉任何現有的自動化會話。

調試模式

要查看詳細日誌，你可以修改服務器以包含更詳細的輸出，或者在自動化運行時檢查 Safari 的 Web 檢查器。

貢獻代碼

1. 分叉倉庫。
2. 創建一個功能分支。
3. 進行更改。
4. 如有必要，添加測試。
5. 提交拉取請求。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

相關項目

• 模型上下文協議
• MCP TypeScript SDK
• Selenium WebDriver
• Safari WebDriver 文檔