Compare Html

What is Compare Html?

Compare Html is an MCP (Model Context Protocol) server that allows AI assistants to programmatically compare two HTML values and return their structural differences. It is part of the @compare-html/cli package and targets developers who need automated HTML comparison in AI-driven workflows.

How to use Compare Html?

Start the MCP server by running npx @compare-html/cli --mcp in your terminal. AI assistants can then call the compare_html tool, providing at least one base input (baseHTML string or baseHTMLFilePath) and one contrast input (contrastHTML string or contrastHTMLFilePath). The server returns an array of HTMLValueDifference objects describing each change.

Key features of Compare Html

• Compares two HTML strings or files and returns structural differences.
• Supports both inline HTML and file-based input.
• Outputs detailed difference objects with path and type.
• Provided via an easy-to-use MCP server command.
• Also available as an online playground at comparehtml.com.

Use cases of Compare Html

• AI-assisted code review: detect changes between HTML versions.
• Automated testing: validate rendered HTML output against expected structures.
• Content migration: compare HTML documents from different sources to identify structural modifications.

FAQ from Compare Html

How do I start the MCP server for Compare Html?

Run npx @compare-html/cli --mcp in your terminal. The server will be available for AI assistants to call the compare_html tool.

What inputs does the compare_html tool require?

You must provide at least one base input (baseHTML string or baseHTMLFilePath) and one contrast input (contrastHTML string or contrastHTMLFilePath). All parameters are optional but at least one pair is required.

What does the output of compare_html look like?

The tool returns an array of HTMLValueDifference objects, each containing fields like pathSegments, pathString, displayPath, pathBelongsTo, and diffType (e.g., "valueChanged").

Does Compare Html require any external dependencies?

The README does not specify additional dependencies beyond Node.js and the @compare-html/cli package itself. The server is started via npx, which fetches the package automatically.

Where is my HTML data processed?

The README does not detail data handling. The MCP server runs locally when started with npx, so data is processed on your machine. The online playground at comparehtml.com may have separate privacy terms.