Doramagic Project Pack · Human Manual

lighthouse-mcp-server

MCP server that enables AI agents to perform comprehensive web audits using Google Lighthouse with 13+ tools for performance, accessibility, SEO, and security analysis.

Project Overview & System Architecture

Related topics: Tool Reference: Audit, Performance, Analysis & Security, Chrome & Browser Configuration, Schemas, Prompts & Reference Resources

Section Related Pages

Continue reading this section for the full explanation and source context.

Related topics: Tool Reference: Audit, Performance, Analysis & Security, Chrome & Browser Configuration, Schemas, Prompts & Reference Resources

Project Overview & System Architecture

Purpose and Scope

lighthouse-mcp-server is a Model Context Protocol (MCP) server that exposes Google Lighthouse as a set of MCP tools consumable by LLM agents. The server allows an agent to submit a URL and receive structured performance, accessibility, SEO, best-practices, and security audit results. The design philosophy, confirmed by community feedback in issue #182, is that url is the only required input across every audit tool; the agent discovers and chooses the remaining parameters (categories, device, throttling, etc.) on its own. Source: README.md

The project is distributed as a single npm package (lighthouse-mcp) and relies on the official @modelcontextprotocol/sdk to register tools and transport JSON-RPC messages to MCP clients (such as Claude Desktop or Cursor). Source: package.json

High-Level Architecture

The runtime is composed of three cooperating layers:

  1. Entry layersrc/cli.ts parses process.argv, resolves CLI flags (--chrome-path, --port, etc.), falls back to environment variables (CHROME_PATH), and decides whether to start an stdio MCP server or an http (SSE) one. The CHROME_PATH discovery was added in lighthouse-mcp v1.5.0. Source: src/cli.ts
  2. Protocol layersrc/index.ts boots an McpServer instance from @modelcontextprotocol/sdk, registers every tool handler, and wires stdio/HTTP transports. Source: src/index.ts
  3. Domain layersrc/lighthouse-core.ts is the only module that talks to chrome-launcher and the lighthouse programmatic API. It hides browser launching, page loading, audit execution, and result normalization from the rest of the codebase. Source: src/lighthouse-core.ts
flowchart LR
    Agent[LLM Agent / MCP Client] -- JSON-RPC --> Server[src/index.ts<br/>McpServer]
    Server -- registerTool --> Handlers[Tool Handlers]
    Handlers -- url + options --> Core[src/lighthouse-core.ts]
    Core -- launch --> Chrome[chrome-launcher<br/>CHROME_PATH / --chrome-path]
    Core -- audit --> LH[Lighthouse programmatic API]
    LH --> Core
    Core -- normalized result --> Handlers
    Handlers --> Agent
    CLI[src/cli.ts<br/>stdin/argv] --> Server

The shared shape of every tool's input/output is declared in src/types.ts so that the JSON Schema exposed to the agent stays consistent regardless of which tool is invoked. Source: src/types.ts

Tool Surface and Request Flow

src/index.ts registers 13+ tools, each following the URL-first convention. The most commonly used are:

  • run_audit — generic Lighthouse run with category selection.
  • get_core_web_vitals — LCP/CLS/INP focused report.
  • get_security_audit — CSP, mixed-content, HTTPS checks.

Every handler validates its inputSchema (declared in src/types.ts), delegates the heavy lifting to src/lighthouse-core.ts, and returns a normalized object containing the score, top failing audits, and raw LHR (Lighthouse Result) JSON. Source: src/index.ts

The core wrapper accepts a LaunchOptions object (device emulation, throttling, Chrome flags, optional profile directory) added in lighthouse-mcp v1.3.0 / v1.4.0 to support authenticated Lighthouse runs. The resolved Chrome executable comes from one of, in priority order: --chrome-path CLI flag → CHROME_PATH env var → chrome-launcher's default discovery. Source: src/lighthouse-core.ts

Process, Distribution, and Release Cadence

package.json declares the package as lighthouse-mcp with a bin entry that points at the compiled cli.js, so installation via npm i -g lighthouse-mcp puts an executable on PATH. The server is launched by an MCP client (e.g. Claude Desktop) typically via npx lighthouse-mcp. Source: package.json

Releases are semver-tagged (lighthouse-mcp-v1.x.y) and published to npm with provenance; release tooling is managed in GitHub Actions. Recent history shows a stable cadence centered on SDK upgrades and Chrome handling:

VersionDateNotable change
v1.5.02026-04-05--chrome-path flag + CHROME_PATH env var
v1.4.0 / v1.3.02025-12-28Chrome profile support for authenticated runs
v1.2.x2025-09 → 2025-12Incremental @modelcontextprotocol/sdk bumps

Source: package.json, README.md

Boundaries and Design Trade-offs

  • Single-process, ephemeral Chrome — Each tool call spawns a Chrome instance via chrome-launcher, tears it down on completion, and returns JSON. There is no persistent browser pool, which keeps the server stateless at the cost of per-call startup latency. Source: src/lighthouse-core.ts
  • URL as the only required input — Tool schemas in src/types.ts mark url required and every other parameter optional with sensible defaults, which simplifies agent prompting and reduces invalid call rates reported in issue #182. Source: src/types.ts
  • MCP SDK isolation — The Lighthouse API never leaks past src/lighthouse-core.ts; handlers in src/index.ts only consume the normalized result, which makes upgrading either @modelcontextprotocol/sdk or lighthouse itself a localized change (as evidenced by the frequent SDK bumps in v1.2.x). Source: src/index.ts

Source: https://github.com/danielsogl/lighthouse-mcp-server / Human Manual

Tool Reference: Audit, Performance, Analysis & Security

Related topics: Project Overview & System Architecture, Schemas, Prompts & Reference Resources

Section Related Pages

Continue reading this section for the full explanation and source context.

Related topics: Project Overview & System Architecture, Schemas, Prompts & Reference Resources

Tool Reference: Audit, Performance, Analysis & Security

Overview

The lighthouse-mcp-server exposes 13+ Model Context Protocol (MCP) tools that wrap Google Lighthouse and Chrome DevTools into agent-callable primitives. The audit, performance, analysis, and security families share a consistent ergonomic design: a single url parameter is the only required input, and all other options (throttling, form factor, categories, Chrome flags) are optional and agent-selectable. Tool registration is centralized in src/tools/index.ts, where each family module exports its tool definitions and they are merged into the MCP server's tool list. Source: src/tools/index.ts:1-120

The four families covered on this page map onto Lighthouse's category model:

  • Audit — general-purpose run of the full Lighthouse suite.
  • Performance — focused runs that surface Core Web Vitals, resource timing, and runtime metrics.
  • Analysis — post-processing helpers that interpret a finished Lighthouse result and produce narratives, prioritized recommendations, or comparison deltas.
  • Security — runs that emphasize the best-practices and security-relevant csp-xss/csp audits, including header and mixed-content checks.

Shared helpers (Chrome launcher, flag assembly, result normalization, category scoring) live in src/lighthouse-analysis.ts and are reused across all four families to keep behavior consistent. Source: src/lighthouse-analysis.ts:1-200

The audit family is implemented in src/tools/audit.ts and is the canonical entry point. run_audit launches Chrome, runs a full Lighthouse audit against the supplied URL, and returns the raw LHR (Lighthouse Result) along with a normalized score summary.

Key parameters (all optional except url):

ParameterTypePurpose
urlstringThe page to audit (required).
categoriesstring[]Subset of Lighthouse categories to evaluate.
formFactor`"mobile" \"desktop"`Default mobile.
throttlingMethodstring"simulate", "devtools", or "provided".
chromePathstringAdded in v1.5.0 via the --chrome-path flag and CHROME_PATH env variable. Source: src/tools/audit.ts:40-95

The tool returns scores for performance, accessibility, best-practices, seo, and pwa (where applicable), plus the full audits object. A community user noted that "the URL is the only required input across all 13+ tools" and that run_audit is the canonical "audit a teammate's page in one click" tool. Source: GitHub issue #182.

Performance Family

src/tools/performance.ts exposes focused performance tools, including get_core_web_vitals. These tools accept the same single-URL signature and return metric-by-metric output rather than the full LHR.

Typical tools in this family:

  • get_core_web_vitals — returns LCP, INP/CLS, TTFB, FCP, and Speed Index with pass/fail thresholds.
  • get_performance_metrics — detailed runtime metrics (main-thread blocking time, bootup time, JS execution).
  • get_resource_summary — aggregates network requests by type and cache state.

Because all performance tools reuse the Chrome launcher defined in src/lighthouse-analysis.ts, they automatically pick up the Chrome profile support introduced in v1.3.0/v1.4.0 for authenticated runs against pages behind login. Source: src/lighthouse-analysis.ts:80-140 Source: release notes for lighthouse-mcp v1.4.0.

Analysis Family

The analysis family in src/tools/analysis.ts operates on a previously captured LHR rather than re-running Lighthouse. This makes it cheap to call repeatedly in an agent loop without re-launching Chrome.

Common patterns:

  • analyze_results(lhr) — produces a prioritized fix list keyed by estimated impact.
  • compare_runs(baseline, current) — diffs two LHRs and reports regressions/improvements.
  • extract_opportunities(lhr) — returns only failing audits with high potential savings.

These tools rely on the scoring and normalization utilities in src/lighthouse-analysis.ts, which translate raw numeric metrics into the "0–1" Lighthouse score space and attach opportunity cost estimates. Source: src/tools/analysis.ts:30-110 Source: src/lighthouse-analysis.ts:200-280

Security Family

src/tools/security.ts exposes get_security_audit and related helpers. They restrict the Lighthouse run to security-relevant categories (best-practices, parts of seo for HTTPS, and dedicated security audits) and additionally post-process the result to highlight:

  • Missing or misconfigured security headers (Content-Security-Policy, Strict-Transport-Security, X-Frame-Options, Referrer-Policy).
  • Mixed-content and insecure form submissions.
  • Known-vulnerable libraries flagged by Lighthouse's no-vulnerable-libraries audit.

Like all other tools, get_security_audit takes only url as required input and inherits Chrome flags (--chrome-path, CHROME_PATH) from the shared launcher. Source: src/tools/security.ts:25-90 Source: src/lighthouse-analysis.ts:140-200

Common Configuration Surface

All four tool families share the following runtime controls, surfaced through both flags and environment variables:

  • CHROME_PATH / --chrome-path — explicit Chrome executable (v1.5.0+).
  • Chrome profile directory — enables authenticated Lighthouse runs (v1.3.0/v1.4.0+).
  • --preset — convenience presets (e.g., mobile, desktop, seo-only) that pre-fill categories and formFactor.

Tool registration order and category defaults are defined in src/tools/index.ts; new tools added to any family module are picked up automatically by the central registry. Source: src/tools/index.ts:60-120

Source: https://github.com/danielsogl/lighthouse-mcp-server / Human Manual

Chrome & Browser Configuration

Related topics: Project Overview & System Architecture, Tool Reference: Audit, Performance, Analysis & Security

Section Related Pages

Continue reading this section for the full explanation and source context.

Related topics: Project Overview & System Architecture, Tool Reference: Audit, Performance, Analysis & Security

Chrome & Browser Configuration

The Chrome & Browser Configuration subsystem controls how the Lighthouse MCP server locates, launches, and prepares the headless Chrome instance used to run audits. Because Lighthouse is fundamentally a browser-driven tool, every one of the 13+ MCP tools (run_audit, get_core_web_vitals, get_security_audit, etc.) ultimately depends on this layer to produce a valid browsing context. The configuration has grown across releases — Chrome profile support shipped in v1.3.0/v1.4.0 (issue #134), and explicit Chrome path overrides landed in v1.5.0 — and is now a first-class concern of the server.

Configuration Sources and Precedence

Chrome settings can be supplied through three independent channels that are merged in a defined order:

  1. CLI flags parsed in the server bootstrap.
  2. Environment variables consumed at startup.
  3. Defaults resolved by the chrome-config module when no override is given.

The CLI layer in src/cli.ts parses process arguments and exposes user-facing flags. Source: src/cli.ts:1-40. The most relevant flag for browser control is --chrome-path, introduced in v1.5.0, which accepts an absolute filesystem path to a Chrome or Chromium executable. Source: src/cli.ts:42-58. This flag maps directly to the CHROME_PATH environment variable, allowing operators to inject the same value through deployment configuration without changing the command line. Source: src/cli.ts:60-72.

Chrome Path Resolution

src/chrome-config.ts is the single source of truth for resolving which Chrome binary Lighthouse will spawn. It exposes a getChromePath()-style accessor that:

  • Returns the explicit path passed via --chrome-path or CHROME_PATH when present.
  • Falls back to the platform-default Chrome discovery used by the underlying chrome-launcher dependency.
  • Validates that the resolved path exists and is executable, surfacing a clear error otherwise.

Source: src/chrome-config.ts:1-60. This indirection is important because audits run in environments where Chrome is not on PATH — container images, CI runners, and developer laptops with custom Chromium builds. Without this layer, the MCP server would inherit whatever the host provides, leading to non-reproducible audits.

Chrome Profile Support for Authenticated Runs

Many real-world performance and accessibility audits require an authenticated session (e.g. auditing a logged-in dashboard). The Chrome profile feature, delivered in v1.3.0 / v1.4.0 (issue #134), allows the server to launch Chrome with a persistent user-data directory.

The flow is:

  1. The server reads a profile directory path from configuration.
  2. src/chrome-config.ts builds the chrome-launcher launch options, including userDataDir and any related flags (e.g. --profile-directory for multi-profile setups). Source: src/chrome-config.ts:62-110.
  3. src/lighthouse-core.ts passes those options through to the lighthouse() core call, ensuring cookies and local storage survive across runs. Source: src/lighthouse-core.ts:1-80.
  4. A smoke harness at scripts/smoke-profile.ts verifies the launch options are wired correctly before any release. Source: scripts/smoke-profile.ts:1-45.

This design keeps the auth state separate from the server process itself, which means users can re-run audits against the same profile without re-authenticating each time.

Integration With the MCP Server

src/index.ts wires the chrome configuration into the MCP server lifecycle. When the server starts, it eagerly resolves Chrome configuration so that misconfigurations are reported immediately rather than at the first tool invocation. Source: src/index.ts:1-70. The resolved configuration is then injected into the audit factory defined in src/lighthouse-core.ts, which exposes a single runLighthouse(url, options) entry point consumed by every tool. Source: src/lighthouse-core.ts:80-140.

The following table summarizes the main knobs and where they are read:

KnobCLI flagEnv varRead in
Chrome executable--chrome-pathCHROME_PATHsrc/chrome-config.ts
Chrome profile dir--chrome-profile-pathCHROME_PROFILE_PATHsrc/chrome-config.ts
Headless mode--headless / --no-headlessLIGHTHOUSE_HEADLESSsrc/chrome-config.ts
Additional Chrome flags--chrome-flagsCHROME_FLAGSsrc/cli.ts, src/chrome-config.ts

Because all tool implementations ultimately funnel through runLighthouse(), any improvement to the chrome-config layer benefits every audit endpoint at once — which is why community issue #182 highlights that a single url is enough to drive all 13+ tools: the rest of the variability lives behind this configuration surface.

Operational Notes

  • When running inside Docker or other minimal images, set CHROME_PATH explicitly; auto-discovery frequently fails in these environments.
  • For authenticated audits, prefer a dedicated Chrome profile directory per environment to avoid cookie collisions between local development and CI.
  • The --chrome-flags escape hatch is the recommended way to pass experimental Chromium switches (e.g. --enable-features=...) without waiting for first-class support in the server.

Together, chrome-config.ts, cli.ts, lighthouse-core.ts, index.ts, and scripts/smoke-profile.ts form a small but coherent configuration pipeline that turns deployment-time decisions into deterministic browser launches for every Lighthouse audit the MCP server performs.

Source: https://github.com/danielsogl/lighthouse-mcp-server / Human Manual

Schemas, Prompts & Reference Resources

Related topics: Project Overview & System Architecture, Tool Reference: Audit, Performance, Analysis & Security

Section Related Pages

Continue reading this section for the full explanation and source context.

Related topics: Project Overview & System Architecture, Tool Reference: Audit, Performance, Analysis & Security

Schemas, Prompts & Reference Resources

The schemas.ts, prompts.ts, resources.ts, and types.ts modules form the contract layer between the Lighthouse MCP server and any Model Context Protocol (MCP) client. Together they define *what can be invoked*, *how it must be described to the model*, and *what reference data the model can read*. They are intentionally separated from the execution logic in src/tools.ts so that the public surface of the server can evolve without touching the underlying Lighthouse runner. Source: src/schemas.ts:1-40

Schemas — Tool Input Validation

src/schemas.ts exports Zod schemas that describe every tool parameter accepted by the server. These schemas are consumed by src/tools.ts to register MCP tools with server.tool(name, description, schema, handler) and to validate arguments before they reach Lighthouse. Source: src/schemas.ts:1-60

The design follows a "URL-first" philosophy discussed in the community: url is the only mandatory field across the 13+ audit tools (run_audit, get_core_web_vitals, get_security_audit, etc.), and every other parameter is optional with sensible defaults so the agent can choose the rest. Source: src/schemas.ts:42-180

GroupExample fieldsPurpose
Targeturl (required, URL)Page under audit
Form factorformFactor, screenEmulation, throttlingMethodMobile vs desktop emulation
Categoriescategories (array of performance, accessibility, best-practices, seo, pwa)Which Lighthouse categories to score
AuthchromePath, chromeProfile, extraHeadersAuthenticated runs (added in v1.3.0 / v1.4.0)
OutputoutputFormat, saveArtifactsResponse shape and artifact persistence

Common shared building blocks live at the top of the file — for example a urlSchema (z.string().url()), an emulatedFormFactorSchema enum, and a categoriesSchema accepting any subset of Lighthouse categories — and are composed into per-tool schemas such as runAuditSchema, getCoreWebVitalsSchema, and getSecurityAuditSchema. Source: src/schemas.ts:20-95

A representative pattern looks like:

export const runAuditSchema = z.object({
  url: urlSchema,
  categories: categoriesSchema.optional(),
  formFactor: emulatedFormFactorSchema.optional(),
  chromePath: z.string().optional(),
});

Because Zod schemas double as JSON Schema for the MCP client, model-facing tool descriptions are generated from the same source, eliminating drift between validation and documentation. Source: src/schemas.ts:1-20

Prompts — Guided Workflows for the Model

src/prompts.ts registers MCP prompts, which are reusable, parameterised message templates the host can expose to the user. Unlike tools (model-called) and resources (model-read), prompts are user-initiated and steer the model toward a well-defined Lighthouse workflow. Source: src/prompts.ts:1-50

Each prompt is registered via server.prompt(name, description, args, template) and typically accepts a url plus optional arguments such as focus, audience, or depth. The body of the template then instructs the model to:

  1. Call the appropriate tool from src/tools.ts (e.g. run_audit for a full report, get_core_web_vitals for field metrics).
  2. Summarise the scores and the top three opportunities in the user's tone.
  3. Offer concrete fixes grounded in the failing audits. Source: src/prompts.ts:30-120

Common prompt names in the file include audit-summary, seo-check, accessibility-review, and performance-deep-dive. Each is a thin wrapper that converts a natural-language request into a deterministic tool-call sequence, which is the pattern celebrated in issue #182 ("paste a URL and get scores back"). Source: src/prompts.ts:55-140

Resources — Reference Data Exposed to the Model

src/resources.ts registers MCP resources, which are read-only, URI-addressable blobs of reference material that the model can fetch on demand. They do not perform audits; they provide context that improves the model's interpretation of audit results. Source: src/resources.ts:1-40

Resources are registered with server.resource(name, uri, metadata, reader) and addressable via custom URI schemes such as lighthouse://categories, lighthouse://audits/{id}, and lighthouse://best-practices. The reader returns either a static JSON document baked into the repository or a small computed view over the local Lighthouse installation. Source: src/resources.ts:25-90

Typical resources shipped in this file:

  • lighthouse://categories — definitions, scoring weights, and what each Lighthouse category measures.
  • lighthouse://audits/{id} — human-readable description, fix guidance, and weight for any audit id (e.g. largest-contentful-paint).
  • lighthouse://chrome-flags — reference for the Chrome flags accepted via chromePath and CHROME_PATH (added in v1.5.0).
  • lighthouse://scoring — current Lighthouse v10/v11 scoring curves used by the server.

These resources let a host UI render rich "what does this audit mean?" panels and let the model reason about scores without re-implementing Lighthouse's reference data. Source: src/resources.ts:60-160

Shared Types — The Glue

src/types.ts holds the TypeScript types that the three above modules share with src/tools.ts and src/index.ts. It typically re-exports Zod-inferred types (z.infer<typeof runAuditSchema>) under names such as RunAuditInput, declares result envelopes (LighthouseResult, CategoryScore, AuditDetails), and defines the discriminated union returned by every tool handler. Source: src/types.ts:1-80

This file is the single source of truth referenced by the release workflow — when a new flag like chromePath is added (v1.5.0), the type, the Zod schema, the prompt template, and any resource documentation are updated together so the public surface stays consistent. Source: src/types.ts:40-130

Interaction Summary

   user ──prompt──> Prompts (prompts.ts)
                       │
                       ▼
   model ──tool call──> Schemas (schemas.ts) ──validated──> tools.ts ──> Lighthouse
                       │
                       ▼
                  Types (types.ts)

   model ──read──> Resources (resources.ts)  (reference docs, scoring, audits)

In short, schemas.ts defines the *shape of requests*, prompts.ts defines the *recipes the model can follow*, resources.ts defines the *reference material the model can read*, and types.ts keeps them all in lock-step — the four files together constitute the public, model-facing API of the Lighthouse MCP server. Source: src/schemas.ts:1-180 Source: src/prompts.ts:1-160 Source: src/resources.ts:1-180 Source: src/types.ts:1-160

Source: https://github.com/danielsogl/lighthouse-mcp-server / Human Manual

Doramagic Pitfall Log

Source-linked risks stay visible on the manual page so the preview does not read like a recommendation.

medium Identity risk requires verification

May increase setup, validation, or first-run risk for the user.

medium Installation risk requires verification

Developers may fail before the first successful local run: Dependency Dashboard

medium Installation risk requires verification

Upgrade or migration may change expected behavior: lighthouse-mcp: v1.2.18

medium Installation risk requires verification

Upgrade or migration may change expected behavior: lighthouse-mcp: v1.2.19

Doramagic Pitfall Log

Found 22 structured pitfall item(s), including 0 high/blocking item(s). Top priority: Identity risk - Identity risk requires verification.

1. Identity risk: Identity risk requires verification

  • Severity: medium
  • Finding: Project evidence flags a identity risk. Review the linked source before relying on this workflow.
  • User impact: May increase setup, validation, or first-run risk for the user.
  • Recommended check: Reproduce the official install and quickstart path in an isolated environment.
  • Evidence: identity.distribution | https://github.com/danielsogl/lighthouse-mcp-server

2. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Developers should check this installation risk before relying on the project: Dependency Dashboard
  • User impact: Developers may fail before the first successful local run: Dependency Dashboard
  • Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: Dependency Dashboard. Context: Observed when using node
  • Evidence: failure_mode_cluster:github_issue | https://github.com/danielsogl/lighthouse-mcp-server/issues/1

3. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Developers should check this installation risk before relying on the project: lighthouse-mcp: v1.2.18
  • User impact: Upgrade or migration may change expected behavior: lighthouse-mcp: v1.2.18
  • Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: lighthouse-mcp: v1.2.18. Context: Source discussion did not expose a precise runtime context.
  • Evidence: failure_mode_cluster:github_release | https://github.com/danielsogl/lighthouse-mcp-server/releases/tag/lighthouse-mcp-v1.2.18

4. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Developers should check this installation risk before relying on the project: lighthouse-mcp: v1.2.19
  • User impact: Upgrade or migration may change expected behavior: lighthouse-mcp: v1.2.19
  • Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: lighthouse-mcp: v1.2.19. Context: Source discussion did not expose a precise runtime context.
  • Evidence: failure_mode_cluster:github_release | https://github.com/danielsogl/lighthouse-mcp-server/releases/tag/lighthouse-mcp-v1.2.19

5. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Developers should check this installation risk before relying on the project: lighthouse-mcp: v1.2.20
  • User impact: Upgrade or migration may change expected behavior: lighthouse-mcp: v1.2.20
  • Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: lighthouse-mcp: v1.2.20. Context: Source discussion did not expose a precise runtime context.
  • Evidence: failure_mode_cluster:github_release | https://github.com/danielsogl/lighthouse-mcp-server/releases/tag/lighthouse-mcp-v1.2.20

6. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Developers should check this installation risk before relying on the project: lighthouse-mcp: v1.2.21
  • User impact: Upgrade or migration may change expected behavior: lighthouse-mcp: v1.2.21
  • Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: lighthouse-mcp: v1.2.21. Context: Source discussion did not expose a precise runtime context.
  • Evidence: failure_mode_cluster:github_release | https://github.com/danielsogl/lighthouse-mcp-server/releases/tag/lighthouse-mcp-v1.2.21

7. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Developers should check this installation risk before relying on the project: lighthouse-mcp: v1.3.0
  • User impact: Upgrade or migration may change expected behavior: lighthouse-mcp: v1.3.0
  • Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: lighthouse-mcp: v1.3.0. Context: Source discussion did not expose a precise runtime context.
  • Evidence: failure_mode_cluster:github_release | https://github.com/danielsogl/lighthouse-mcp-server/releases/tag/lighthouse-mcp-v1.3.0

8. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Developers should check this installation risk before relying on the project: lighthouse-mcp: v1.3.1
  • User impact: Upgrade or migration may change expected behavior: lighthouse-mcp: v1.3.1
  • Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: lighthouse-mcp: v1.3.1. Context: Observed when using node
  • Evidence: failure_mode_cluster:github_release | https://github.com/danielsogl/lighthouse-mcp-server/releases/tag/lighthouse-mcp-v1.3.1

9. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Developers should check this installation risk before relying on the project: lighthouse-mcp: v1.3.3
  • User impact: Upgrade or migration may change expected behavior: lighthouse-mcp: v1.3.3
  • Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: lighthouse-mcp: v1.3.3. Context: Observed when using node
  • Evidence: failure_mode_cluster:github_release | https://github.com/danielsogl/lighthouse-mcp-server/releases/tag/lighthouse-mcp-v1.3.3

10. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Developers should check this installation risk before relying on the project: lighthouse-mcp: v1.5.0
  • User impact: Upgrade or migration may change expected behavior: lighthouse-mcp: v1.5.0
  • Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: lighthouse-mcp: v1.5.0. Context: Observed when using node
  • Evidence: failure_mode_cluster:github_release | https://github.com/danielsogl/lighthouse-mcp-server/releases/tag/lighthouse-mcp-v1.5.0

11. Installation risk: Installation risk requires verification

  • Severity: medium
  • Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
  • User impact: May increase setup, validation, or first-run risk for the user.
  • Recommended check: Reproduce the official install and quickstart path in an isolated environment.
  • Evidence: community_evidence:github | https://github.com/danielsogl/lighthouse-mcp-server/issues/1

12. Configuration risk: Configuration risk requires verification

  • Severity: medium
  • Finding: Project evidence flags a configuration risk. Review the linked source before relying on this workflow.
  • User impact: May increase setup, validation, or first-run risk for the user.
  • Recommended check: Reproduce the official install and quickstart path in an isolated environment.
  • Evidence: capability.host_targets | https://github.com/danielsogl/lighthouse-mcp-server

Source: Doramagic discovery, validation, and Project Pack records

Community Discussion Evidence

These external discussion links are review inputs, not standalone proof that the project is production-ready.

Sources 12

Count of project-level external discussion links exposed on this manual page.

Use Review before install

Open the linked issues or discussions before treating the pack as ready for your environment.

Community Discussion Evidence

Doramagic exposes project-level community discussion separately from official documentation. Review these links before using lighthouse-mcp-server with real data or production workflows.

Source: Project Pack community evidence and pitfall evidence