{"id":28323768,"url":"https://github.com/phialsbasement/pagespeed-mcp-server","last_synced_at":"2025-06-24T00:30:57.269Z","repository":{"id":269529396,"uuid":"907700210","full_name":"PhialsBasement/Pagespeed-MCP-Server","owner":"PhialsBasement","description":"Pull pagespeed data using this MCP server.","archived":false,"fork":false,"pushed_at":"2025-05-05T11:41:31.000Z","size":29,"stargazers_count":5,"open_issues_count":1,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-17T13:05:29.400Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PhialsBasement.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-24T07:19:47.000Z","updated_at":"2025-05-18T02:02:07.000Z","dependencies_parsed_at":"2024-12-24T08:27:52.384Z","dependency_job_id":"36b3143f-7632-41d7-95a0-bbb1cf724447","html_url":"https://github.com/PhialsBasement/Pagespeed-MCP-Server","commit_stats":null,"previous_names":["phialsbasement/pagespeed-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PhialsBasement/Pagespeed-MCP-Server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhialsBasement%2FPagespeed-MCP-Server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhialsBasement%2FPagespeed-MCP-Server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhialsBasement%2FPagespeed-MCP-Server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhialsBasement%2FPagespeed-MCP-Server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PhialsBasement","download_url":"https://codeload.github.com/PhialsBasement/Pagespeed-MCP-Server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhialsBasement%2FPagespeed-MCP-Server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261582493,"owners_count":23180602,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-25T16:14:45.945Z","updated_at":"2025-06-24T00:30:57.257Z","avatar_url":"https://github.com/PhialsBasement.png","language":"JavaScript","funding_links":[],"categories":["Search \u0026 Data Extraction"],"sub_categories":["How to Submit"],"readme":"[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/phialsbasement-pagespeed-mcp-server-badge.png)](https://mseep.ai/app/phialsbasement-pagespeed-mcp-server)\n\n# PageSpeed MCP Server\n[![smithery badge](https://smithery.ai/badge/mcp-pagespeed-server)](https://smithery.ai/server/mcp-pagespeed-server)\n\nA Model Context Protocol (MCP) server that extends AI assistant capabilities with PageSpeed Insights functionality. This server acts as a bridge between AI models and Google's PageSpeed Insights API, enabling detailed performance analysis of websites.\n\n## Overview\n\nThe PageSpeed MCP server is designed to enhance AI assistants' capabilities by allowing them to perform comprehensive web performance analysis. When integrated, AI models can request and interpret detailed performance metrics, Core Web Vitals, and other critical web performance data for any given URL.\n\n## Installation\n\n### Installing via Smithery\n\nTo install PageSpeed Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-pagespeed-server):\n\n```bash\nnpx -y @smithery/cli install mcp-pagespeed-server --client claude\n```\n\n### Manual Installation\n```bash\nnpm install pagespeed-mcp-server\n```\n\n## Configuration\n\nAdd the PageSpeed MCP to your AI assistant's(claude in this case) configuration file:\n\n```json\n{\n    \"pagespeed\": {\n        \"command\": \"node\",\n        \"args\": [\"path/to/mcp-pagespeed-server/dist/index.js\"]\n    }\n}\n```\n\n## Detailed Capabilities\n\n### Performance Metrics Analysis\n- First Contentful Paint (FCP)\n- Largest Contentful Paint (LCP)\n- Time to Interactive (TTI)\n- Total Blocking Time (TBT)\n- Cumulative Layout Shift (CLS)\n- Speed Index\n- Time to First Byte (TTFB)\n\n### Best Practices Assessment\n- HTTPS usage\n- JavaScript error monitoring\n- Browser console warnings\n- Deprecated API usage\n- Image aspect ratio analysis\n- Link security checks\n\n### SEO Analysis\n- Meta description validation\n- Robots.txt validation\n- Structured data validation\n- Crawlable links verification\n- Meta tags assessment\n- Mobile friendliness\n\n### Accessibility Audits\n- ARIA attribute validation\n- Color contrast checking\n- Heading hierarchy analysis\n- Alt text verification\n- Focus management assessment\n- Keyboard navigation testing\n\n### Resource Optimization\n- Image optimization suggestions\n- JavaScript bundling analysis\n- CSS optimization recommendations\n- Cache policy validation\n- Resource minification checks\n- Render-blocking resource identification\n\n## API Response Structure\n\nThe MCP server provides detailed JSON responses including:\n\n```javascript\n{\n    \"lighthouseResult\": {\n        \"categories\": {\n            \"performance\": { /* Performance metrics */ },\n            \"accessibility\": { /* Accessibility results */ },\n            \"best-practices\": { /* Best practices audit */ },\n            \"seo\": { /* SEO findings */ }\n        },\n        \"audits\": {\n            // Detailed audit results for each category\n        },\n        \"timing\": {\n            // Performance timing data\n        },\n        \"stackPacks\": {\n            // Technology-specific advice\n        }\n    }\n}\n```\n\n## Advanced Usage\n\n### Custom Configuration\nYou can customize the PageSpeed analysis by providing additional parameters:\n\n```json\n{\n    \"strategy\": \"mobile\", // or \"desktop\"\n    \"category\": [\"performance\", \"accessibility\", \"best-practices\", \"seo\"],\n    \"locale\": \"en\",\n    \"threshold\": {\n        \"performance\": 90,\n        \"accessibility\": 100,\n        \"best-practices\": 90,\n        \"seo\": 90\n    }\n}\n```\n\n### Error Handling\nThe MCP server includes robust error handling for:\n- Invalid URLs\n- Network timeouts\n- API rate limiting\n- Invalid parameters\n- Server-side errors\n\n## Requirements\n\n\n### Network Requirements\n- Stable internet connection\n- Access to Google's PageSpeed Insights API\n\n### Platform Support\n- Windows (x64, x86)\n- Linux (x64)\n- macOS (x64, arm64)\n\n## Integration Examples\n\n### Basic Integration\n```javascript\nconst PageSpeedMCP = require('pagespeed-mcp-server');\nconst mcp = new PageSpeedMCP();\n\nawait mcp.analyze('https://example.com');\n```\n\n### With Custom Options\n```javascript\nconst results = await mcp.analyze('https://example.com', {\n    strategy: 'mobile',\n    categories: ['performance', 'accessibility'],\n    locale: 'en-US'\n});\n```\n\n## Troubleshooting\n\n### Common Issues\n1. Connection Timeouts\n   - Check internet connectivity\n\n2. API Rate Limiting\n   - Use API key for higher limits\n\n3. Memory Issues\n   - Adjust Node.js memory limits\n\n## Development\n\n### Building from Source\n```bash\ngit clone https://github.com/phialsbasement/mcp-pagespeed-server\ncd mcp-pagespeed-server\nnpm install\nnpm run build\n```\n\n### Running Tests\n```bash\nnpm run test\n```\n\n### Contributing\n1. Fork the repository\n2. Create a feature branch\n3. Commit your changes\n4. Push to the branch\n5. Create a Pull Request\n\n## Support\n\n### Getting Help\n- GitHub Issues: Report bugs and feature requests\n\n## License\n\nMIT License - See LICENSE file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphialsbasement%2Fpagespeed-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphialsbasement%2Fpagespeed-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphialsbasement%2Fpagespeed-mcp-server/lists"}