Performance Analysis MCP Server
Provides capabilities for auditing web page performance using Google Lighthouse, including collecting performance metrics and generating reports.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Performance Analysis MCP Server check page performance for https://www.lowes.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Performance Analysis MCP Server
Lightweight MCP server for collecting page performance metrics (Playwright + CDP + Lighthouse) and returning a normalized PerformanceReport.
Prerequisites
Node.js (16+ recommended)
npm
Optional: network access to target URLs
Related MCP server: web-performance-mcp
Install
npm install
# Install Playwright browsers (required for collectors)
npx playwright installBuild / Type-check / Test
npm run build
npm run lint
npm testRun as MCP Server
The default command starts an MCP stdio server with an analyze_page tool.
npm startThe MCP tool accepts:
{ "url": "https://example.com" }It returns a human-readable summary plus structured PerformanceReport content.
Run HTTP Compatibility Server
The HTTP server is available for local testing and non-MCP clients. You can provide a default URL via DEFAULT_URL or pass a URL in each request.
npm run start:httpWith a default URL:
DEFAULT_URL=https://example.com npx ts-node src/index.ts http --no-promptServer API
GET /health→ returns{ ok: true }POST /analyzewith JSON{ "url": "https://..." }→ returns analysis JSON plussummarystring.
Example using curl (returns JSON file):
curl -s -X POST http://localhost:3333/analyze \
-H "Content-Type: application/json" \
-d '{"url":"https://www.lowes.com"}' -o report.jsonOne-off analyze (CLI)
npx ts-node src/index.ts analyze https://www.lowes.com > report.jsonThe CLI prints JSON followed by a human-readable summary.
Files of interest
src/schema/performance-report.ts— canonical schema and validatorsrc/collectors/playwright.ts— Playwright collectorsrc/collectors/cdp.ts— CDP network capture helpersrc/tools/analyze-page.ts— orchestrates collectors and adapts resultssrc/tools/lighthouse.ts— Lighthouse runner (Phase 2)src/tools/format-report.ts— text formatter for human-friendly outputsrc/server/mcp.ts— MCP stdio server andanalyze_pagetoolsrc/server/http.ts— HTTP compatibility server
Troubleshooting
If Playwright complains about missing browsers, run
npx playwright install.If
tscnot found, runnpm installto install devDependencies.
Next steps
Add automated recommendations, persistence, or LLM analysis integration.
Available Tools
1 toolanalyze_pageAnalyze Page PerformanceARead-only
Collect page performance metrics for a public http(s) URL using Playwright and CDP.
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion between tools; the purpose is singular and clear.
The single tool follows a consistent verb_noun pattern (analyze_page), which is clear and predictable.
The server claims to be a Performance Analysis MCP Server but provides only one tool, which is too few for the implied broader scope. A single tool feels thin and under-scoped.
The server covers only basic page performance metrics. Missing tools for audits, comparisons, history, or reporting create significant gaps for a performance analysis server.
Maintenance
Related MCP Connectors
Lighthouse scores, Core Web Vitals (LCP, CLS, INP/TBT) and top fixes for any URL, mobile or desktop.
Run Google Lighthouse audits on any URL — performance, SEO, accessibility scores.
Run Google Lighthouse on public page URLs for performance, accessibility, best-practices and SEO
Read any page with its JavaScript run: Markdown, screenshots, metadata, console errors, Lighthouse.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI models to perform Google Lighthouse website performance analysis, including Core Web Vitals, accessibility, SEO audits, and actionable optimization recommendations. Provides comprehensive web performance insights through natural language interactions.4MIT
- AlicenseBqualityDmaintenanceEnables web performance analysis using Google PageSpeed Insights and Chrome UX Report APIs, providing compact metrics and diagnostics without local browser automation.56 npmMIT
- AlicenseNot gradedqualityCmaintenanceRuns Google PageSpeed Insights audits against any public URL, returning Lighthouse scores, lab timing metrics, ranked fixes, and real-user Chrome UX Report field data.87 npmMIT
- AlicenseAqualityBmaintenanceEnables MCP clients to run fresh audits of any public web page on mobile or desktop, returning category scores, lab metrics, and prioritized findings for performance, accessibility, best practices, and SEO. Each call performs a new uncached audit, so users can compare results within a conversation.11MIT