HTML MCP 服务器

通过 Model Context Protocol 为 AI 助手提供 HTML 对比能力。

@compare-html/cli 内置 MCP(Model Context Protocol)服务器,通过 compare_html 工具向 AI 助手提供本地 HTML 对比能力。

配置 MCP 客户端

将服务器添加到 MCP 客户端配置中,例如 mcp.json:

{
  "mcpServers": {
    "compare-html": {
      "command": "npx",
      "args": ["@compare-html/cli@latest", "--mcp"]
    }
  }
}

服务器使用 stdio 传输。MCP 客户端会启动 CLI 进程,并向助手提供该工具。

调用 compare_html

工具的每一侧都接受字符串或文件路径:

参数类型必填说明
baseHTMLstring否基准 HTML 字符串
baseHTMLFilePathstring否基准 HTML 文件路径
contrastHTMLstring否对照 HTML 字符串
contrastHTMLFilePathstring否对照 HTML 文件路径

必须至少提供一个基准输入和一个对照输入。文件路径在 MCP 服务器运行的环境中解析,因此助手和服务器必须能够访问这些路径。

当前工具没有对比选项参数。它使用 added、deleted 和 valueChanged 变化类型返回 HTML 结构差异。

阅读输出

结果包含由 HTMLValueDifference 对象组成的 differences 数组。例如,类名变化可能包含:

{
  "differences": [
    {
      "pathSegments": ["0", "@class"],
      "pathString": "0.@class",
      "contrastPathString": "0.@class",
      "displayPath": "div > @class",
      "pathBelongsTo": "both",
      "diffType": "valueChanged"
    }
  ]
}

displayPath 提供易读的位置,diffType 表示变化类型。路径字段还标识解析输入中的对应位置。

如需不通过 MCP 直接对比文件或字符串,请参阅 AI 编码助手 HTML Skills。