figcraft-mcp-flash
Exports designs as Android Vector Drawable XML for use as Android app vector assets.
Supports opening and saving Figma .fig files, allowing AI agents to inspect, edit, and export Figma-format design documents through FigCraft.
Supports opening Penpot .penpot files for inspection and editing within the FigCraft design engine.
Supports opening Sketch .sketch files for inspection and editing within the FigCraft design engine.
Supports opening and exporting SVG vector graphics, enabling import and export of SVG design assets.
Provides export to Android Vector Drawable XML, a specialized XML format for Android vector assets.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
figcraft-mcp-flash
Universal Model Context Protocol (MCP) server and harness bridge for FigCraft, the next-generation native vector design engine.
Enable any AI agent (Claude Desktop, Cursor, Windsurf, Cline, Roo Code, VynexCode, Hermes) to create, inspect, edit, auto-layout, prototype, and export vector design documents in real-time.
⚡ Highlights
Dual-Mode Intelligence:
Attached GUI Mode: Automatically detects running FigCraft app (
figcraft --control 9005) for live real-time canvas updates, pointer interactions, and app window screenshots.Headless Mode: Falls back to headless in-process engine mode if GUI is closed. Perfect for CLI scripts, CI/CD pipelines, and automated asset generation.
Cross-Platform Auto-Detection: Discovers
figcraft-clibinaries automatically across Windows (Program Files,AppData), macOS (/Applications), and Linux (/usr/bin,~/.local/bin).Universal Format Support: Works natively with
.figcraft, Figma files (.fig), Penpot (.penpot), Sketch (.sketch), SVG (.svg), and REST JSON.Production-Grade Auto Layout: Flexbox-style automatic layouts (
horizontal,vertical,grid), hug/fill sizing, padding, gaps, and responsive constraints.Full Fidelity Exporter: Single-call export to PNG, JPG, SVG, WebP, print-ready PDF (with bleed/crop marks), and Android Vector Drawable XML.
Related MCP server: figmad-mcp
🚀 Quick Start
1. Clone & Verify
git clone https://github.com/bagjasatrio/figcraft-mcp-flash.git
cd figcraft-mcp-flashRun the built-in diagnostic test to verify your environment and FigCraft connection:
node scripts/test-connection.jsSample output:
=== FIGCRAFT MCP ENVIRONMENT DIAGNOSTIC ===
OS: Windows_NT 10.0.26200 (x64)
Node.js: v24.19.0
[✓] figcraft-cli located at: C:\Program Files\ArtCraft\FigCraft\figcraft-cli.exe
[✓] FigCraft CLI Version: figcraft-cli 0.18.1
[✓] FigCraft GUI is RUNNING on port 9005 (Interactive Attached Mode ready)
[✓] MCP Initialize Handshake Successful! (figcraft v0.18.1)
[✓] tools/list Successful! 19 design tools available.
=== DIAGNOSTIC PASSED: Ready for all Agent Harnesses! ===🔌 Setup Guide for All Harnesses
1. Claude Desktop
Edit your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add the server:
{
"mcpServers": {
"figcraft": {
"command": "node",
"args": [
"C:\\path\\to\\figcraft-mcp-flash\\bin\\figcraft-mcp-bridge.js"
],
"env": {
"FIGCRAFT_PORT": "9005"
}
}
}
}2. Cursor IDE
Workspace Level
Create .cursor/mcp.json in your project root:
{
"mcpServers": {
"figcraft": {
"command": "node",
"args": [
"C:\\path\\to\\figcraft-mcp-flash\\bin\\figcraft-mcp-bridge.js"
]
}
}
}Global Level
Open Cursor Settings (Ctrl + , / Cmd + ,) -> Features -> MCP, click Add New MCP Server:
Name:
figcraftType:
commandCommand:
node <absolute-path>/bin/figcraft-mcp-bridge.js
3. Windsurf (Codeium)
Edit %USERPROFILE%\.codeium\windsurf\mcp_config.json (or ~/.codeium/windsurf/mcp_config.json on macOS/Linux):
{
"mcpServers": {
"figcraft": {
"command": "node",
"args": [
"/path/to/figcraft-mcp-flash/bin/figcraft-mcp-bridge.js"
]
}
}
}4. VS Code (Cline & Roo Code)
In VS Code extension settings, open MCP settings:
{
"mcpServers": {
"figcraft": {
"command": "node",
"args": [
"C:\\path\\to\\figcraft-mcp-flash\\bin\\figcraft-mcp-bridge.js"
],
"disabled": false,
"autoApprove": [
"inspect_document",
"get_node",
"screenshot",
"inspect_ui",
"list_commands"
]
}
}
}5. VynexCode / Hermes Agent / Codex
In your workspace or global .codeagent/mcp.json or mcp.json:
{
"mcpServers": {
"Figcraft": {
"command": "node",
"args": [
"path/to/figcraft-mcp-flash/bin/figcraft-mcp-bridge.js"
]
}
}
}🎨 Interactive GUI vs Headless Mode
Feature | Interactive Attached Mode | Headless Mode |
How to run | Start FigCraft GUI with | Automatic fallback when GUI is not open |
Canvas View | Real-time live visual sync on your screen | Headless memory engine |
Window Screenshot | Yes ( | Renders canvas page / layers |
Interactions | Mouse clicks, drags, selections, typing | Programmatic API calls |
Performance | Ideal for interactive visual co-design | Ultra-fast, ideal for CI/CD & batch jobs |
To launch FigCraft GUI in control mode:
# Windows
"C:\Program Files\ArtCraft\FigCraft\figcraft.exe" --control 9005
# macOS
/Applications/FigCraft.app/Contents/MacOS/figcraft --control 9005🛠 Available Tools (19 Tools)
Tool | Description |
| Create layer: frame, rectangle, text, vector, component, etc. |
| Set colors, typography, auto-layout, padding, borders, shadows |
| Run multiple commands atomically in one undo step with |
| Retrieve full JSON tree of active document, hierarchy, and tokens |
| Deep inspect specific layer subtree with offset pagination |
| Visual verification: returns PNG render of layers, canvas, or GUI |
| Export to PNG, JPG, SVG, WebP, PDF (print bleed), or Android XML |
| Open |
| Save active file ( |
| List available commands with filters and parameter schemas |
| Execute low-level engine command directly |
| Programmatically select layers on the canvas |
| Traverse undo / redo history stack |
| Synthesize mouse gestures: click, double-click, marquee drag |
| Press keyboard shortcut, tool switch keys, or nudge arrows |
| Type text directly into canvas text layers |
| Check UI status, zoom level, viewport center, and active tool |
| Long-poll listener for comments and design review updates |
💡 Practical Examples
1. Create a Complete Card via batch
{
"commands": [
{
"as": "card",
"command": "node.create",
"params": {
"type": "frame",
"name": "Feature Card",
"width": 320,
"height": 180,
"props": {
"layout": "vertical",
"padding": 20,
"gap": 12,
"cornerRadius": 16,
"fill": "#0F172A"
}
}
},
{
"command": "node.create",
"params": {
"type": "text",
"text": "Instant Analytics",
"parent": { "$ref": "card" },
"props": { "fontSize": 18, "fontStyle": "Bold", "fill": "#FFFFFF" }
}
}
]
}2. Visual Verification via screenshot
{
"maxSize": 1200,
"scale": 2
}⚙ CLI Options & Environment Variables
Usage: node bin/figcraft-mcp-bridge.js [options]
Options:
--port <port> Target port for FigCraft GUI socket (default: 9005)
--cli <path> Explicit path to figcraft-cli binary
--headless Force headless mode (bypass port probe)
--attach [port] Force attach mode (fail if port unreachable)
--no-system-fonts Use built-in fonts only for pixel-identical renders
--help, -h Show help message
Environment Variables:
FIGCRAFT_CLI_PATH Custom path to figcraft-cli binary
FIGCRAFT_PORT Default GUI control socket port (default: 9005)📄 License
MIT License. See LICENSE for details. Crafted for the global open-source AI and design community.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Agent-Native design tool - create and edit visual designs with agent assistance
Give your AI agents a design superpower. Generate, edit, and publish publication-grade decks, reports, landing pages, resumes, and marketing visuals directly within your agent workflow. Delivering frontier-level design quality at 3× the speed and 53× lower cost -from conversational prompt to live link or vector PDF in minutes.
Design canvas for agents: create, edit, render and export Figma-shaped designs over MCP.
Your AI agent designs editable, clickable UI prototypes on a live canvas.
Related MCP Servers
- -licenseCqualityNot gradedmaintenanceEnables AI agents to interact with Figma in real-time through a WebSocket connection. Supports comprehensive design operations including text manipulation, layouts, components, variables, and export functionality.72207 npm-
- AlicenseAqualityDmaintenanceEnables AI agents to interact with Figma to create, read, and manage designs using the Figma REST API and a dedicated plugin. It supports advanced features like UI generation from text, webpage reconstruction in Figma, and design token synchronization with codebases.20MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to inspect, modify, export, and validate design documents with 47 tools covering design, code generation, branding, and print/mockup workflows.2MIT
- AlicenseBqualityAmaintenanceEnables AI-driven UI/UX design and prototyping in Figma by letting agents generate AutoLayout screens, modify canvas elements, and wire interactive prototype flows through natural language.47MIT