项目简介

Webby MCP Server 是一款功能强大的网站验证工具,它将多种领先的网站分析服务(如Google PageSpeed Insights、WebPageTest、Axe DevTools、SSL Labs等)集成到一个统一的MCP服务器中。通过调用其提供的工具,您可以轻松评估网站在不同维度上的健康状况,无需直接与各个复杂API交互。

主要功能点

  • 性能测试: 使用Google PageSpeed Insights、WebPageTest(通过浏览器自动化)和GTmetrix分析网站加载速度、核心网络指标和整体性能评分。
  • 可访问性测试: 利用Axe DevTools(通过浏览器自动化)和WAVE API检查网站是否符合WCAG标准,发现可访问性缺陷。
  • SEO测试: 整合PageSpeed Insights的SEO审计功能,评估网站的搜索引擎优化表现。
  • 安全测试: 通过Mozilla Observatory分析HTTP安全头配置,并使用SSL Labs深度检测SSL/TLS证书和协议的安全性。
  • 综合报告: 提供类别级和全面的验证工具,一次性运行多项测试并生成汇总报告,简化网站诊断流程。

安装步骤

  1. 打开命令行终端。
  2. 导航到您希望安装Webby MCP Server的目录。 例如,您可以选择 '/home/youruser/mcp-servers/servers/src/webby' 作为安装路径。请替换为您实际选择的路径。
    cd /home/youruser/mcp-servers/servers/src/webby
  3. 安装项目依赖:
    npm install
  4. 编译项目:
    npm run build
    完成此步骤后,将在项目目录下生成一个 'dist' 文件夹,其中包含编译后的JavaScript文件,例如 'dist/index.js'。

服务器配置

要将Webby MCP Server连接到您的MCP客户端,您需要提供以下JSON格式的配置信息。请将'your_install_path'替换为您在安装步骤2中选择的Webby MCP Server的实际安装路径。

{
  "name": "webby",
  "command": "node",
  "args": [
    "/your_install_path/dist/index.js" 
  ],
  "description": "一个提供网站性能、可访问性、SEO和安全验证功能的MCP服务器。"
}
  • 'name': MCP客户端中显示的服务名称,推荐使用 '"webby"'。
  • 'command': 启动Webby MCP Server的命令,这里是 '"node"'。
  • 'args': 传递给 'command' 的参数列表。其中 '"/your_install_path/dist/index.js"' 需要替换为 'npm run build' 后生成的 'index.js' 文件的实际完整路径。例如,如果您的安装路径是 '/home/youruser/mcp-servers/servers/src/webby',那么这里就应该是 '"/home/youruser/mcp-servers/servers/src/webby/dist/index.js"'。
  • 'description': 对该MCP服务器功能的简要描述,方便用户理解。

基本使用方法

一旦Webby MCP Server在您的MCP客户端中配置并成功连接,您就可以通过MCP客户端的工具调用界面来使用它。以下是一些示例调用情景(具体调用方式取决于您的MCP客户端实现):

  • 调用页面速度测试 ('validate_performance_pagespeed'):

    // 假设MCP客户端的API允许您直接调用名为"webby"的服务器上的工具
    client.callTool("webby", "validate_performance_pagespeed", {
      url: "https://www.example.com",
      strategy: "desktop" // 可选参数:desktop (桌面) 或 mobile (移动)
    });

    此调用将返回 'example.com' 在桌面策略下的PageSpeed Insights性能报告,包括核心网络指标和性能分数。

  • 运行所有可访问性测试 ('validate_all_accessibility'):

    client.callTool("webby", "validate_all_accessibility", {
      url: "https://www.example.com",
      wcagLevel: "wcag2aa", // 为Axe工具指定WCAG级别,如 wcag2a, wcag2aa, wcag22aa
      // waveApiKey: "YOUR_WAVE_API_KEY" // 如果需要通过WAVE进行测试,请提供WAVE API密钥
    });

    此调用将同时运行Axe和可选的WAVE(如果提供了API密钥)进行可访问性分析,并返回汇总结果。

  • 进行综合网站验证 ('validate_comprehensive'):

    client.callTool("webby", "validate_comprehensive", {
      url: "https://www.example.com",
      email: "[email protected]", // SSL Labs需要邮件地址
      categories: ["performance", "security"], // 可选参数:指定要测试的类别,如 performance, accessibility, seo, security
      pagespeedApiKey: "YOUR_PAGESPEED_API_KEY", // 可选参数:提供PageSpeed API密钥以获取更高配额
      webpagetestEnabled: true, // 可选参数:启用WebPageTest(基于浏览器自动化,可能耗时)
      waitForSSL: true // 可选参数:等待SSL Labs测试完成(可能耗时较长)
    });

    此调用将针对 'example.com' 执行性能和安全方面的全面测试(或其他您指定的类别),并提供一个包含所有结果的综合报告和整体健康评分。

信息

分类

开发者工具