svg-compare-mcp

A MCP tool for comparing SVG files in a project.

Features

1. Compare SVG files by providing either a file path or SVG content
2. Scan the entire project directory by default, or a specific directory
3. Return a list of identical SVG files with their names and paths if found
4. Save the new SVG file to the target directory with a unique name if no identical files are found

Installation

npm install

Usage

Parameters

| Parameter | Type | Description | Required | Default | |-----------|------|-------------|----------|---------| | svgSource | string | SVG source, can be a file path or SVG content | Yes | - | | targetDir | string | Target directory to scan, default is project root | No | Project root | | isContent | boolean | Whether the svgSource is SVG content, default is false | No | false |

Examples

1. Compare an SVG file with all SVG files in the project:

node index.js --svgSource path/to/your/svg/file.svg

2. Compare an SVG file with all SVG files in a specific directory:

node index.js --svgSource path/to/your/svg/file.svg --targetDir src/icons

3. Compare SVG content with all SVG files in the project:

node index.js --svgSource "<svg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24'><path d='M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-2 15l-5-5 1.41-1.41L10 14.17l7.59-7.59L19 8l-9 9z'/></svg>" --isContent true

4. Compare SVG content with all SVG files in a specific directory:

node index.js --svgSource "<svg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24'><path d='M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-2 15l-5-5 1.41-1.41L10 14.17l7.59-7.59L19 8l-9 9z'/></svg>" --isContent true --targetDir src/icons

Output

If identical SVG files are found:

{
  "success": true,
  "message": "Same SVG files found",
  "sameSvgList": [
    {
      "name": "icon1.svg",
      "path": "src/icons/icon1.svg"
    },
    {
      "name": "icon2.svg",
      "path": "src/icons/icon2.svg"
    }
  ]
}

If no identical SVG files are found:

{
  "success": true,
  "message": "SVG file saved successfully",
  "savedPath": "src/icons/new_svg.svg"
}

How It Works

1. The tool reads the SVG source (either from a file or provided content)
2. It scans the specified directory (or the entire project) for all SVG files
3. It compares the content of each SVG file with the source SVG
4. If identical files are found, it returns a list of those files
5. If no identical files are found, it saves the source SVG to the target directory with a unique name

Dependencies

This MCP has no external dependencies. It uses only Node.js built-in modules:

• fs: For file system operations
• path: For path handling

License

MIT