Pagespeed MCP Server

🚀 PageSpeed MCP 服務器

PageSpeed MCP 服務器是一個增強 AI 助手功能的模型上下文協議（MCP）服務器，集成了 PageSpeed Insights 功能。它作為 AI 模型與 Google 的 PageSpeed Insights API 之間的橋樑，可實現對網站性能的詳細分析。

🚀 快速開始

PageSpeed MCP 服務器旨在提升 AI 助手的能力，使其能夠執行全面的網絡性能分析。當集成後，AI 模型可以請求並解析指定 URL 的詳細性能指標、核心網頁關鍵指標（Core Web Vitals）及其他重要網絡性能數據。

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 自動安裝 Claude Desktop 的 PageSpeed 服務器：

npx -y @smithery/cli install mcp-pagespeed-server --client claude

手動安裝

npm install pagespeed-mcp-server

📚 詳細文檔

配置

將 PageSpeed MCP 添加到 AI 助手（Claude）的配置文件中：

{
    "pagespeed": {
        "command": "node",
        "args": ["path/to/mcp-pagespeed-server/dist/index.js"]
    }
}

詳細功能

性能指標分析

• 首次內容繪製（FCP）
• 最大內容繪製（LCP）
• 交互時間（TTI）
• 總阻塞時間（TBT）
• 佈局偏移累積（CLS）
• Speed Index 指數
• 首字節時間（TTFB）

最佳實踐評估

• HTTPS 使用情況
• JavaScript 錯誤監控
• 瀏覽器控制檯警告
• 已棄用 API 的使用
• 圖片寬高比分析
• 鏈接安全檢查

SEO 分析

• Meta 描述驗證
• Robots.txt 文件驗證
• 結構化數據驗證
• 可爬取鏈接驗證
• Meta 標籤評估
• 移動設備友好性檢測

可訪問性審計

• ARIA 屬性驗證
• 顏色對比檢查
• 標題層次結構分析
• alt 文本驗證
• 焦點管理評估
• 鍵盤導航測試

資源優化

• 圖片優化建議
• JavaScript 包分析
• CSS 優化推薦
• 緩存策略驗證
• 資源最小化檢查
• 渲染阻塞資源識別

API 響應結構

MCP 服務器提供詳細的 JSON 響應，包括：

{
    "lighthouseResult": {
        "categories": {
            "performance": { /* 性能指標 */ },
            "accessibility": { /* 可訪問性結果 */ },
            "best-practices": { /* 最佳實踐評估 */ },
            "seo": { /* SEO 分析 */ }
        },
        "details": {
            "performanceMetrics": [/* 性能指標詳情 */],
            "accessibilityIssues": [/* 可訪問性問題 */],
            "optimizationSuggestions": [/* 優化建議 */]
        }
    }
}

高級用法

自定義配置

在配置文件中添加自定義設置：

{
    "pagespeed": {
        "command": "node",
        "args": ["path/to/mcp-pagespeed-server/dist/index.js"],
        "config": {
            "performanceThreshold": 90,
            "accessibilityScore": "AA"
        }
    }
}

錯誤處理

處理可能出現的錯誤：

try {
    const result = await pagespeed.analyze(url);
    console.log(result);
} catch (error) {
    console.error("分析失敗:", error.message);
}

要求

• 平臺支持: 支持 Windows、Linux 和 macOS 系統。
• Node.js 版本: 需要 Node.js 14 或更高版本。

獲取幫助

如需支持，請訪問 GitHub Issues 報告問題和功能請求。

📄 許可證

MIT License - 詳見 LICENSE 文件