Webtools MCP Server

🚀 網絡工具 MCP 服務器

網絡工具 MCP 服務器是一個綜合性的 Web 分析平臺，集成了多種實用工具，可用於網站分析、性能測試和質量保障。它能幫助用戶深入瞭解網站情況，提升網站性能與質量。

🚀 快速開始

網絡工具 MCP 服務器集成了多種工具，可用於網站分析、性能測試和質量保障。用戶可根據需求選擇合適的工具進行操作。

✨ 主要特性

• HTML 頁面抓取：獲取網頁內容，支持 JavaScript 渲染。
• 截圖生成：捕獲網頁視圖，返回 Base64 編碼的 PNG 圖像。
• 燈塔審核：執行 Lighthouse 審核，分析網站性能和 SEO。
• 性能測試：跨設備和網絡條件模擬真實用戶場景。
• 代碼覆蓋分析：評估 JavaScript 代碼使用情況。
• 調試工具：診斷頁面錯誤，監控佈局抖動。

📦 安裝指南

若在安裝 Chrome 時遇到問題，請重新安裝包：

npm install -g @bschauer/webtools-mcp-server

💻 使用示例

基礎用法

以下是使用網頁抓取工具的示例：

{
  "content": [
    {
      "type": "text",
      "text": "..." // Markdown 格式報告
    }
  ]
}

高級用法

以下是屏幕截圖工具的響應示例：

{
  "content": [
    {
      "type": "image",
      "data": "...", // Base64 編碼 PNG
      "mimeType": "image/png"
    }
  ]
}

📚 詳細文檔

工具說明

網頁抓取工具

• 基本功能：獲取網頁 HTML 內容。
• 參數選項：
  • url：必填，目標網址。
  • waitForSelector：可選，默認 null，等待特定選擇器出現。
  • timeout：默認 30 秒，設置超時時間。

截圖工具

• 功能特點：
  • 返回 Base64 編碼的 PNG 圖像。
  • 支持自定義視口大小和縮放比例。
  • 提供截圖預覽 URL 鏈接。

燈塔審核工具

• 核心指標：
  • First Contentful Paint (FCP)
  • Largest Contentful Paint (LCP)
  • Time to Interactive (TTI)
  • Cumulative Layout Shift (CLS)

響應格式

所有工具均採用以下統一響應格式：

{
  "content": [
    {
      "type": "text",
      "text": "..." // Markdown 格式報告
    }
  ]
}

最佳實踐

1. 逐步分析：從基礎 HTML 抓取開始，再使用高級分析工具。
2. 按需渲染：僅在需要 JavaScript 內容時啟用渲染功能。
3. 合理設置超時：為複雜頁面設置足夠長的超時時間。
4. 使用選擇器：通過選擇器指定目標區域以優化抓取範圍。
5. 有條件使用代理：僅在訪問受地理限制的內容時啟用代理。

故障排除

Chrome 安裝問題

• 注意事項：Chrome 已通過 Puppeteer 自動安裝，無需額外操作。
• 解決方法：若遇問題，請重新安裝包 npm install -g @bschauer/webtools-mcp-server。

連接問題

• 現象：無法連接到網站。
• 排查：檢查 URL 格式、網站可用性或啟用代理。

安全考量

• 工具可訪問任意網站，請謹慎使用。
• 代理功能需謹慎使用，並遵守相關法律法規。
• 除非絕對必要，否則保持 SSL 證書驗證開啟狀態。

📄 許可證

項目遵循 MIT 許可證，歡迎社區貢獻代碼和文檔。

如需更多信息，請參考原始英文文檔或直接聯繫開發團隊。