Lighthouse MCP

🚀 燈塔 MCP 服務器

燈塔 MCP 服務器圍繞 Google 的 Lighthouse 工具構建，可幫助測量網頁的各項性能指標，為網頁性能評估提供有力支持。

🚀 快速開始

燈塔 MCP 服務器能助力你對網頁性能進行有效測量。配置好服務器後，你可以在 Claude 中使用它，例如詢問 example.com 的性能分數是多少？，Claude 將使用 get_performance_score 工具來分析網站並返回結果。

✨ 主要特性

• 對任意 URL 運行全面的燈塔審核
• 獲取性能分數和指標
• 配置設備仿真（手機/桌面）
• 控制網絡節流
• 選擇特定的審核類別

📦 安裝指南

選項 1：使用 npx（推薦）

可以直接使用 npx 運行工具而不進行安裝：

npx lighthouse-mcp

選項 2：全局安裝

全局安裝包：

npm install -g lighthouse-mcp

然後運行它：

lighthouse-mcp

選項 3：本地開發

1. 克隆此倉庫
2. 安裝依賴：

   npm install
   

3. 構建項目：

   npm run build
   

4. 運行服務器：

   npm start
   

📚 詳細文檔

MCP 配置

當通過 npm 安裝（全局或 npx）

在你的 MCP 設置配置文件中添加以下內容：

{
  "mcpServers": {
    "lighthouse": {
      "command": "npx",
      "args": ["lighthouse-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

當使用本地開發版本時

在你的 MCP 設置配置文件中添加以下內容：

{
  "mcpServers": {
    "lighthouse": {
      "command": "node",
      "args": ["/絕對路徑/到/lighthouse-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

將 /絕對路徑/到/lighthouse-mcp 替換為你項目的實際路徑。

可用工具

run_audit

對一個 URL 運行全面的燈塔審核。

參數：

• url（必填）：要審核的 URL
• categories（可選）：要審核的類別數組（默認為所有）
  • 選項："performance", "accessibility", "best-practices", "seo", "pwa"
• device（可選）：要仿真的設備（默認為 "mobile"）
  • 選項："mobile", "desktop"
• throttling（可選）：是否應用網絡節流（默認為 true）

示例：

{
  "url": "https://example.com",
  "categories": ["performance", "accessibility"],
  "device": "desktop",
  "throttling": false
}

get_performance_score

僅獲取某個 URL 的性能分數。

參數：

• url（必填）：要審核的 URL
• device（可選）：要仿真的設備（默認為 "mobile"）
  • 選項："mobile", "desktop"

示例：

{
  "url": "https://example.com",
  "device": "mobile"
}

🔧 技術細節

• 要求：
  • Node.js 16+
  • 瀏覽器：Chrome、Firefox 等現代瀏覽器

📄 許可證

燈塔 MCP 服務器授權鏈接