Playwright-Lighthouse MCP 服务器

这是一个使用 Playwright 和 Lighthouse 分析网站性能的 MCP 服务器。通过模型上下文协议（MCP），LLMs 可以执行网站性能分析。

特性

• 使用 Lighthouse 进行性能分析
• 截图捕获

安装

先决条件

• Node.js 18 或更高版本
• npm

安装步骤

# 克隆仓库
git clone https://github.com/kbyk004/playwright-lighthouse-mcp.git
cd playwright-lighthouse-mcp

# 安装依赖
npm install
npx playwright install

# 构建
npm run build

使用方法

调试 MCP 服务器

npm run inspector

与 MCP 客户端集成

此服务器设计用于与支持模型上下文协议（MCP）的客户端一起使用。例如，它可以与桌面版 Claude 集成。

桌面版 Claude 配置示例

在桌面版 Claude 的配置文件中添加以下内容（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "playwright-lighthouse": {
      "command": "node",
      "args": [
        "/path-to/playwright-lighthouse-mcp/build/index.js"
      ]
    }
  }
}

可用工具

1. run-lighthouse

对当前打开的页面运行 Lighthouse 性能分析。

参数：

• url: 您要分析的网站的 URL
• categories: 要分析的类别数组（默认：["performance"]）
  • 可用类别："performance", "accessibility", "best-practices", "seo", "pwa"
• maxItems: 每个类别显示的最大改进项数（默认：3，最大：5）

2. take-screenshot

捕获当前打开页面的截图。

参数：

• url: 您要捕获的网站的 URL
• fullPage: 如果为 true，则捕获整个页面的截图（默认：false）

输出格式

分析结果包括：

• 各选类别别的总体得分及颜色指示器
• 按类别分组的关键改进区域
• 保存报告文件的路径

许可证

MIT 许可证 - 详情见 LICENSE </中文翻译>