🚀 网络工具 MCP 服务器
网络工具 MCP 服务器是一个综合性的 Web 分析平台，集成了多种实用工具，可用于网站分析、性能测试和质量保障。它能帮助用户深入了解网站情况，提升网站性能与质量。
🚀 快速开始
网络工具 MCP 服务器集成了多种工具，可用于网站分析、性能测试和质量保障。用户可根据需求选择合适的工具进行操作。
✨ 主要特性
- HTML 页面抓取：获取网页内容，支持 JavaScript 渲染。
- 截图生成：捕获网页视图，返回 Base64 编码的 PNG 图像。
- 灯塔审核：执行 Lighthouse 审核，分析网站性能和 SEO。
- 性能测试：跨设备和网络条件模拟真实用户场景。
- 代码覆盖分析：评估 JavaScript 代码使用情况。
- 调试工具：诊断页面错误，监控布局抖动。
📦 安装指南
若在安装 Chrome 时遇到问题，请重新安装包：
npm install -g @bschauer/webtools-mcp-server
💻 使用示例
基础用法
以下是使用网页抓取工具的示例：
{
"content": [
{
"type": "text",
"text": "..." // Markdown 格式报告
}
]
}
高级用法
以下是屏幕截图工具的响应示例：
{
"content": [
{
"type": "image",
"data": "...", // Base64 编码 PNG
"mimeType": "image/png"
}
]
}
📚 详细文档
工具说明
网页抓取工具
- 基本功能：获取网页 HTML 内容。
- 参数选项：
url：必填，目标网址。waitForSelector：可选，默认 null，等待特定选择器出现。timeout：默认 30 秒，设置超时时间。
截图工具
- 功能特点：
- 返回 Base64 编码的 PNG 图像。
- 支持自定义视口大小和缩放比例。
- 提供截图预览 URL 链接。
灯塔审核工具
- 核心指标：
- First Contentful Paint (FCP)
- Largest Contentful Paint (LCP)
- Time to Interactive (TTI)
- Cumulative Layout Shift (CLS)
响应格式
所有工具均采用以下统一响应格式：
{
"content": [
{
"type": "text",
"text": "..." // Markdown 格式报告
}
]
}
最佳实践
- 逐步分析：从基础 HTML 抓取开始，再使用高级分析工具。
- 按需渲染：仅在需要 JavaScript 内容时启用渲染功能。
- 合理设置超时：为复杂页面设置足够长的超时时间。
- 使用选择器：通过选择器指定目标区域以优化抓取范围。
- 有条件使用代理：仅在访问受地理限制的内容时启用代理。
故障排除
Chrome 安装问题
- 注意事项：Chrome 已通过 Puppeteer 自动安装，无需额外操作。
- 解决方法：若遇问题，请重新安装包
npm install -g @bschauer/webtools-mcp-server。
连接问题
- 现象：无法连接到网站。
- 排查：检查 URL 格式、网站可用性或启用代理。
安全考量
- 工具可访问任意网站，请谨慎使用。
- 代理功能需谨慎使用，并遵守相关法律法规。
- 除非绝对必要，否则保持 SSL 证书验证开启状态。
📄 许可证
项目遵循 MIT 许可证，欢迎社区贡献代码和文档。
如需更多信息，请参考原始英文文档或直接联系开发团队。