webtools-mcp-server

🚀 网络工具 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 格式报告
    }
  ]
}

最佳实践

1. 逐步分析：从基础 HTML 抓取开始，再使用高级分析工具。
2. 按需渲染：仅在需要 JavaScript 内容时启用渲染功能。
3. 合理设置超时：为复杂页面设置足够长的超时时间。
4. 使用选择器：通过选择器指定目标区域以优化抓取范围。
5. 有条件使用代理：仅在访问受地理限制的内容时启用代理。

故障排除

Chrome 安装问题

• 注意事项：Chrome 已通过 Puppeteer 自动安装，无需额外操作。
• 解决方法：若遇问题，请重新安装包 npm install -g @bschauer/webtools-mcp-server。

连接问题

• 现象：无法连接到网站。
• 排查：检查 URL 格式、网站可用性或启用代理。

安全考量

• 工具可访问任意网站，请谨慎使用。
• 代理功能需谨慎使用，并遵守相关法律法规。
• 除非绝对必要，否则保持 SSL 证书验证开启状态。

📄 许可证

项目遵循 MIT 许可证，欢迎社区贡献代码和文档。

如需更多信息，请参考原始英文文档或直接联系开发团队。