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
工具的每一侧都接受字符串或文件路径:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
baseHTML | string | 否 | 基准 HTML 字符串 |
baseHTMLFilePath | string | 否 | 基准 HTML 文件路径 |
contrastHTML | string | 否 | 对照 HTML 字符串 |
contrastHTMLFilePath | string | 否 | 对照 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。