figma-restoration-tools
Allows comparing Vue components with Figma designs, capturing high-quality screenshots for pixel-perfect restoration.
Provides tools for Vue component development and restoration, including screenshot capture and visual comparison.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@figma-restoration-tools Compare the Button component with its Figma design."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Figma Restoration MCP Vue Tools
🛠️ 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
🌐 Remote Version (Recommended)
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 designssnapdom_screenshot- Take high-quality component screenshotsoptimize_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 installStep 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 executableNODE_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
Setup: Configure MCP server in Cursor
Screenshot: Use
snapdom_screenshotto capture componentCompare: Use
figma_compareto analyze differencesOptimize: Use
optimize_svgfor asset optimizationIterate: 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
Fork the repository
Create a feature branch (
git checkout -b feature/new-feature)Commit your changes (
git commit -m 'Add new feature')Push to the branch (
git push origin feature/new-feature)Open a Pull Request
📄 License
This project is licensed under the MIT License. See the LICENSE file for details.
🔗 Links
GitHub: tianmuji/figma-restoration-tools
Issues: Report bugs & feature requests
🙏 Acknowledgments
snapDOM: High-quality DOM screenshots
Model Context Protocol: MCP framework
Vue.js: Progressive JavaScript framework
SVGO: SVG optimization library
🎨 Built for developers who demand pixel-perfect component restoration 🎨
Available Tools
3 toolsfigma_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
Scored across 3 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for Mint — AI-powered QA that runs your app in a real browser on every PR.
The Figma MCP server brings Figma design context directly into your AI workflow.
Zero-log MCP server with 49 tools for AI guardrails, secret scanning, MCP linting & EU compliance.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Related MCP Servers
- AlicenseAqualityFmaintenanceComprehensive MCP server for end-to-end UI development, offering tools to generate components, manage design tokens, audit accessibility, autofix issues, inspect live pages, compare screenshots, and more across multiple frameworks.1321 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for automatic Storybook story generation, component analysis, and validation. Auto-detects React frameworks and syncs component documentation.18 npm1MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that simplifies Figma design data, generates code in multiple frameworks, and provides accessibility audits and drift detection, all using a free Figma Personal Access Token without a paid Dev Mode seat.3MIT
- FlicenseAqualityDmaintenanceAn MCP server implementing a 7-stage agentic frontend workflow—from design audit to PR review—including AI-driven component generation, browser validation, E2E testing, and CI self-healing.412 npm-