SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI编程工具mcp-web-validator

mcp-web-validator

mcp-web-validator 是 DigestSEO 推出的开源 MCP 服务器，用于 HTML/CSS 校验、技术 SEO 与无障碍检查、JSON-LD 语法验证、失效链接检测以及响应式截图。它提供本地 stdio 与托管 Streamable HTTP 两种使用方式，可接入 Claude Desktop、Cursor、Codex CLI、Gemini CLI、GitHub Copilot CLI 等支持 MCP 的客户端。本地版支持校验工作区文件并生成截图，托管版仅面向公开网页，不访问本地文件。

访问官网

工具介绍

用途

mcp-web-validator 是一个 MCP（Model Context Protocol）服务器，面向网页质量与技术 SEO 检查。它把 HTML/CSS 校验、技术 SEO 与无障碍检查、JSON-LD 语法验证、失效链接检查以及响应式截图等能力封装为工具，供支持 MCP 的 AI 客户端调用。项目属于 DigestSEO 开源 SEO 工具套件，采用 MIT 许可证。

主要能力

  • HTML 与 CSS 校验：HTML 会发送到 https://html5.validator.nu/（Nu HTML Checker）进行校验；CSS 解析在 DigestSEO Worker 内完成。
  • 技术 SEO 与无障碍检查：对页面进行 SEO 分析与无障碍检查。
  • JSON-LD 语法验证：解析并校验结构化数据语法。
  • 失效链接检查：对符合条件的公开 HTTP(S) URL 发起有上限的 HEAD 请求，必要时回退为有上限的 GET；链接重定向会被报告但不跟随。
  • 响应式截图：本地安装的 screenshot.capture 工具在首次使用时把固定版本的无头浏览器安装到 Puppeteer 缓存，之后复用；可通过 PUPPETEER_CACHE_DIR 自定义缓存位置。
  • 报告工具：生成校验报告。

两种使用方式

仓库刻意提供两个相互独立的 MCP 界面：

  1. 本地安装：通过 npm 包以 stdio 方式运行，支持校验工作区文件与响应式截图。
  2. 托管端点：远程 Streamable HTTP 服务，仅能访问公开网页，无法访问本地文件或创建截图。

托管应用暴露八个工具，其中：

  • audit_public_webpage：最多跟随三个经过校验的重定向，接受有大小限制的 text/html 响应并记录最终 URL；不爬取额外页面、不执行 JavaScript、不进行身份验证、不抓取链接的样式表和资源。
  • audit_public_site：先锁定最终公开源，再读取有上限的 robots.txt 以及同源的 XML Sitemap、RSS 2.0、Atom 1.0 和纯文本站点地图表示，单次调用最多审计八个符合条件的站点地图页面。robots 发现最多可跨权威跟随五个经过校验的公开重定向；站点地图条目与被审计页面保持同源；私有/保留目标、凭据、自定义端口、服务自抓取以及 HTTPS 到 HTTP 的重定向降级都会被拒绝。该工具不跟随 HTML 链接或外部站点地图条目；当响应提示还有更多符合条件的页面时，可使用 page_offset。

使用方式

本地客户端配置示例（Claude Desktop）：把服务器加入 claude_desktop_config.json，Windows 路径为 %APPDATA%\Claude\claude_desktop_config.json，macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json，保存后重启 Claude Desktop。

Cursor 及兼容客户端：创建 command/stdio 类型的 MCP 服务器。仓库还包含 Cursor Marketplace 插件清单，插件发布后可从 Cursor 市场安装 Web Validator by DigestSEO，或从 Cursor 插件界面添加该仓库；插件捆绑同一个本地 stdio 服务器，不需要 API 密钥或环境变量。

Codex CLI 可直接添加已发布的本地 stdio 包，或改用已有的托管 Streamable HTTP 界面，并用相应命令验证配置。

Gemini CLI 支持本地 stdio MCP 服务器，添加已发布包即可，无需 API 密钥或环境变量。

GitHub Copilot CLI 可添加已发布的本地 stdio 服务器；在仓库克隆内启动 Copilot CLI 时，它还能发现已检入的根目录 .mcp.json，其中已将 mcp-web-validator 指向 npx -y mcp-web-validator。

本地开发：克隆仓库并安装锁定依赖，运行本地质量门禁，运行本地 stdio 服务器，并单独校验托管 Worker。

适用场景

  • 在 AI 客户端中对自有或获授权的网页做 HTML/CSS 校验、SEO 与无障碍检查。
  • 校验 JSON-LD 结构化数据语法。
  • 检查公开页面中的失效链接。
  • 对本地工作区文件做校验并生成响应式截图（仅本地版）。
  • 对公开站点做有限范围的站点地图页面审计（托管版）。

限制与注意事项

  • 仅校验你拥有或获授权检查的文件、标记和公开网页。公开页面 URL 可能包含敏感查询值，提交前应移除令牌和私有标识。不要提交密码、API 密钥、访问令牌、支付数据、健康数据、私有源代码或其他敏感个人数据。
  • 本地服务器与其 MCP 客户端具有相同的操作系统权限；批准文件访问、外部校验、链接检查或截图创建前应审查工具输入。托管应用无法访问你的本地文件系统。
  • 托管版不保留工具输入、抓取的 HTML 或结果。
  • 运行环境要求：Node.js 22.12.0 或更高版本；本地 stdio 需要支持 stdio 的 MCP 客户端，托管端点需要支持 Streamable HTTP 的客户端。
  • 校验、SEO、schema、链接和报告工具在安装时不下载浏览器；只有本地 screenshot.capture 工具会在首次使用时安装无头浏览器。
  • 托管版不做全站链接检查；audit_public_webpage 不爬取额外页面、不执行 JavaScript、不进行身份验证。
  • 数据处理的更多细节见已发布的隐私政策，私有漏洞报告见 SECURITY.md。

链接

  • 仓库：https://github.com/AKzar1el/mcp-web-validator
  • 产品页：digestseo.com/validator-mcp
  • 支持：digestseo.com/support
  • 隐私：digestseo.com/privacy

同类工具

查看分类