Skip to main content
Glama

Figma Restoration MCP Vue Tools

npm version License: MIT Node.js Version

🛠️ Professional Figma Component Restoration Kit - A comprehensive MCP (Model Context Protocol) server for Vue component development and Figma design restoration. Features snapDOM-powered high-quality screenshots, intelligent visual comparison, and automated SVG optimization.

🚀 Features

  • 🎯 High-Quality Screenshots: snapDOM technology with 3x scaling, font embedding, and intelligent shadow detection

  • 🔍 Advanced Visual Comparison: Pixel-perfect analysis with smart difference detection and quality assessment

  • 🎨 SVG Optimization: Built-in SVGO integration with customizable configuration

  • 🤖 MCP Integration: Seamless integration with AI coding assistants (Cursor, Claude, etc.)

Related MCP server: forgekit-storybook-mcp

📦 Quick Start

Use the published npm package for easy setup and automatic updates:

Step 1: Add the MCP server to your Cursor configuration (~/.cursor/mcp.json):

{
  "mcpServers": {
    "figma-restoration-tools": {
      "command": "npx",
      "args": [
        "-y",
        "figma-restoration-tools",
        "start"
      ],
      "env": {
        "PUPPETEER_EXECUTABLE_PATH": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
        "NODE_ENV": "production"
      }
    }
  }
}

Step 2: Restart Cursor after adding the configuration.

Step 3: Use the MCP tools in Cursor:

  • figma_compare - Compare components with Figma designs

  • snapdom_screenshot - Take high-quality component screenshots

  • optimize_svg - Optimize SVG assets

🔧 Local Development Version

For contributors or advanced users who need to modify the source code:

Step 1: Clone and setup the repository:

git clone https://github.com/tianmuji/figma-restoration-tools.git
cd figma-restoration-tools
npm install

Step 2: Add the local MCP server to your Cursor configuration:

{
  "mcpServers": {
    "figma-restoration-tools": {
      "command": "node",
      "args": [
        "/absolute/path/to/figma-restoration-tools/src/server.js"
      ],
      "cwd": "/absolute/path/to/figma-restoration-tools",
      "env": {
        "PUPPETEER_EXECUTABLE_PATH": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
        "NODE_ENV": "development"
      }
    }
  }
}

🛠️ MCP Tools

figma_compare

Advanced component comparison tool that analyzes differences between expected and actual screenshots.

Parameters:

{
  "tool": "figma_compare",
  "arguments": {
    "componentName": "MyComponent",
    "projectPath": "/path/to/your/vue/project",
    "threshold": 0.1,
    "outputPath": "/custom/output/directory"
  }
}

Features:

  • Pixel-perfect difference detection

  • Quality assessment scoring

  • Detailed analysis reports (JSON & Markdown)

  • Customizable comparison threshold

snapdom_screenshot

High-quality DOM screenshot tool using snapDOM technology for precise component capture.

Parameters:

{
  "tool": "snapdom_screenshot", 
  "arguments": {
    "componentName": "MyComponent",
    "projectPath": "/path/to/your/vue/project",
    "port": 3000,
    "viewport": {
      "width": 1440,
      "height": 800
    },
    "snapDOMOptions": {
      "scale": 3,
      "compress": true,
      "embedFonts": true,
      "backgroundColor": "transparent",
      "padding": 0
    },
    "outputPath": "/custom/output/path.png"
  }
}

Features:

  • 3x scaling for high-resolution output

  • Intelligent shadow and effect capture

  • Font embedding support

  • Transparent background support

  • Custom viewport and output settings

optimize_svg

SVG optimization tool powered by SVGO with customizable configuration.

Parameters:

{
  "tool": "optimize_svg",
  "arguments": {
    "inputPath": "/path/to/input.svg",
    "outputPath": "/path/to/optimized.svg",
    "svgoConfig": {
      "plugins": ["preset-default"],
      "multipass": true,
      "floatPrecision": 2
    }
  }
}

Features:

  • Advanced SVG optimization

  • Customizable SVGO configuration

  • Batch processing support

  • Size reduction reports

⚙️ Configuration

Environment Variables

  • PUPPETEER_EXECUTABLE_PATH: Path to Chrome/Chromium executable

  • NODE_ENV: Environment mode (development/production)

Shadow Detection

For components with shadows, the tool automatically calculates optimal padding based on effect data:

{
  "snapDOMOptions": {
    "scale": 3,
    "padding": 0,
    "figmaEffects": [
      {
        "type": "DROP_SHADOW", 
        "offset": {"x": 0, "y": 5}, 
        "radius": 30, 
        "spread": 0
      }
    ]
  }
}

Comparison Thresholds

Threshold

Sensitivity

Use Case

0.0-0.05

Very Strict

Pixel-perfect matching

0.05-0.1

Strict

High-quality components

0.1-0.2

Moderate

General comparison

0.2+

Loose

Rough similarity check

🎯 Typical Workflow

  1. Setup: Configure MCP server in Cursor

  2. Screenshot: Use snapdom_screenshot to capture component

  3. Compare: Use figma_compare to analyze differences

  4. Optimize: Use optimize_svg for asset optimization

  5. Iterate: Refine component based on analysis results

📋 Requirements

  • Node.js: ≥ 18.0.0

  • Chrome/Chromium: For screenshot generation

  • Vue.js project: For component restoration

  • MCP-compatible client: Cursor IDE, Claude Desktop, etc.

🤝 Contributing

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/new-feature)

  3. Commit your changes (git commit -m 'Add new feature')

  4. Push to the branch (git push origin feature/new-feature)

  5. Open a Pull Request

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgments


🎨 Built for developers who demand pixel-perfect component restoration 🎨

Available Tools

3 tools
figma_compareB

Simple Figma component comparison tool: compare existing screenshots and generate diff.png for visual analysis

Inputs: componentName (required), threshold, outputPath, projectPath.

optimize_svgC

Optimize SVG files using SVGO (SVG Optimizer) with customizable configuration

Inputs: inputPath (required), outputPath, svgoConfig.

snapdom_screenshotB

Take high-quality screenshots using snapDOM technology for precise DOM-to-image capture

Inputs: componentName (required), port, selector, viewport, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 3 tools

    Disambiguation4/5

    The three tools have distinct purposes: comparing screenshots, optimizing SVGs, and taking screenshots. There is slight conceptual overlap between figma_compare and snapdom_screenshot, but their roles are clear: one captures, one compares. No two tools appear to do the same thing.

    Naming Consistency3/5

    Names use consistent snake_case, but the pattern is mixed: optimize_svg and snapdom_screenshot are verb-first, while figma_compare is object-first. This is readable but not perfectly predictable.

    Tool Count4/5

    With only 3 tools, the server is on the lighter side, but each tool serves a distinct function in a focused restoration workflow. The count is reasonable for a specialized utility server, though slightly thin.

    Completeness3/5

    The tools cover capture, comparison, and optimization, but the server name suggests a broader restoration workflow. Missing operations like image conversion, batch processing, or asset export create notable gaps that agents may need to work around.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers