lighthouse

The Lighthouse MCP Server provides a dedicated MCP interface to run Google Lighthouse audits via a server you can query with your MCP client. It enables LLMs and AI agents to perform comprehensive web performance analyses, including core web vitals, accessibility checks, SEO insights, and security assessments. Through the MCP protocol, you can initiate audits, fetch results, and tailor Lighthouse runs with CLI-like options such as disabling or enabling headless mode, passing Chrome flags, and connecting to a persistent Chrome profile for authenticated sessions. The server is designed to integrate with MCP clients (VS Code, Cursor, Windsurf, Claude Desktop, etc.) so you can orchestrate automated audits as part of larger workflows.

Prerequisites: Node.js 22.0.0 or newer, a compatible MCP client, and a network environment that can reach npm registry.

1. Install Node.js (if not already installed).
2. Ensure you have npm or pnpm configured to install npm packages.
3. Start the Lighthouse MCP server via your MCP client or command line:

• Using npx (as shown in the README): npx @danielsogl/lighthouse-mcp@latest

4. (Optional) Pin to a specific version: npx @danielsogl/lighthouse-mcp@1.2.3

5. Verify the MCP server appears in your MCP client and is ready to accept commands.

6. If you plan to persist sessions, prepare a Chrome profile path and use the appropriate flags when invoking the server via the MCP client.

Tips and common considerations:

• The server relies on Lighthouse (and a Chrome/Chromium instance managed by Lighthouse) to perform audits; ensure Chrome/Chromium is accessible in your environment.
• When using persistent sessions, profile-path and user-data-dir options help maintain cookies and local storage between audits.
• You can pass additional Chrome flags via --chrome-flag to customize the browser environment; for some flags, prefer the trailing form like --chrome-flag=--disable-gpu.
• Use the MCP client’s standard mcpServers configuration to integrate with other tools; the example in README demonstrates the canonical Lighthouse setup.
• If you encounter network or permission issues, verify that your environment permits executing npx and fetching the Lighthouse MCP package from npm.