figcraft-mcp

Give Google Antigravity, Cursor, Claude Code, Claude Desktop, Windsurf, and other AI-powered coding tools live, real-time control over your FigCraft Desktop canvas with this Model Context Protocol server.

Unlike static CLI bridges that dump layouts in a single frozen frame or generate noisy "AI slop" interfaces, FigCraft-MCP streams every element step-by-step with a live multiplayer cursor (~40ms/element) and enforces a strict Anti-Slop UI design system inspired by Shadcn UI, Radix Primitives, and Apple HIG.

See quickstart instructions ->

Visual Showcase & Demo

1. Real-Time Multiplayer Cursor & Step-by-Step Live Streaming

Every layer (frame, rectangle, text, vector icon) is created step-by-step at 40ms/element with live multiplayer cursor tracking (Antigravity AI) and bounding-box selection highlights on your open FigCraft canvas:

2. Clean, Anti-Slop UI Output (Shadcn / Radix / Apple HIG Standard)

Built-in anti-slop-ui rules prevent AI models from generating neon gradients, gratuitous "AI Insight" or "AI Matched" sparkle badges, loud orange/purple input boxes, or Unicode emojis:

3. Interactive Prototype Flows

Connect buttons, segmented tabs, popup bottom sheets, and navigation bars across all frames with smartAnimate, dissolve, push, slideIn, and moveOut transitions using create_prototype_link:

Related MCP server: OneWright

Quickstart

One command sets up your AI apps (Google Antigravity, Claude Desktop, Claude Code, Cursor, Windsurf, VS Code) and links them to FigCraft Desktop:

macOS / Linux

curl -LsSf https://raw.githubusercontent.com/zuna107/figcraft-mcp/main/install.sh | sh

Windows (PowerShell)

irm https://raw.githubusercontent.com/zuna107/figcraft-mcp/main/install.ps1 | iex

From Command Prompt instead: powershell -c "irm https://raw.githubusercontent.com/zuna107/figcraft-mcp/main/install.ps1 | iex"

Prefer not to run a remote script? Clone the repository or use uvx directly:

git clone https://github.com/zuna107/figcraft-mcp.git
cd figcraft-mcp
pip install -e .
figcraft-mcp setup

Already have uv installed? Run setup directly from GitHub:

uvx --from git+https://github.com/zuna107/figcraft-mcp figcraft-mcp setup

figcraft-mcp setup automatically locates the MCP clients installed on your machine (Google Antigravity, Claude Desktop, Claude Code, Cursor, Windsurf, VS Code), adds the figcraft server entry, and saves a .bak backup of each config file it modifies.

Then fully quit and reopen your AI app, open FigCraft Desktop, and ask your AI agent to design, audit, or prototype screens.

1. Add to mcp_config.json / claude_desktop_config.json / .cursor/mcp.json

{
  "mcpServers": {
    "figcraft": {
      "command": "figcraft-mcp",
      "args": [],
      "env": {
        "FIGCRAFT_PORT": "7979",
        "FIGCRAFT_STREAM_STEPS": "1",
        "FIGCRAFT_STREAM_DELAY_MS": "40"
      }
    }
  }
}

Or run zero-install via Node.js (npx):

{
  "mcpServers": {
    "figcraft": {
      "command": "npx",
      "args": ["-y", "github:zuna107/figcraft-mcp"],
      "env": {
        "FIGCRAFT_PORT": "7979",
        "FIGCRAFT_STREAM_STEPS": "1",
        "FIGCRAFT_STREAM_DELAY_MS": "40"
      }
    }
  }
}

Or run zero-install via uvx:

{
  "mcpServers": {
    "figcraft": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/zuna107/figcraft-mcp", "figcraft-mcp"],
      "env": {
        "FIGCRAFT_PORT": "7979",
        "FIGCRAFT_STREAM_STEPS": "1",
        "FIGCRAFT_STREAM_DELAY_MS": "40"
      }
    }
  }
}

2. Install as a Full Agent Plugin (MCP + Skills + Rules)

To bundle the MCP server together with the figcraft skill, anti-slop-ui skill, and always-on rules/AGENTS.md:

# Google Antigravity (Global Plugin)
git clone https://github.com/zuna107/figcraft-mcp.git ~/.gemini/config/plugins/figcraft-mcp

# Workspace-Scoped Plugin
git clone https://github.com/zuna107/figcraft-mcp.git .agents/plugins/figcraft-mcp

How to Use with FigCraft Desktop

1. Automatic Desktop Attachment (--control 7979):

   • When your AI agent calls any figcraft MCP tool, figcraft-mcp probes TCP port 7979. If FigCraft Desktop is not running yet, it automatically launches the visible desktop app with --control 7979.

2. Live Collaboration Sessions (Sesi langsung):

   • If you start or join a Live Collaboration Session (Bagikan -> Sesi langsung in the top-right corner of FigCraft), figcraft-mcp inspects doc.list and collab.peers to automatically lock onto the active live document and stream every edit directly onto your screen.

3. Example Prompts to Try:

   • "Create Sign In and Create Account screens side-by-side following the anti-slop-ui guidelines with a clean segmented tab switcher."

   • "Update Screen 4 to use a compact searchable category dropdown with an internal vertical scrollbar and a + Category Baru option when a search query is not found."

   • "Audit Screen 5 and Screen 6 to remove AI-slop badges, use neutral colors, and place + Add Wallet directly below the Total Assets card."

   • "Wire interactive prototype flows across all screens on Page 1."

Available MCP Tools (25 Total)

In addition to forwarding all 22 native FigCraft CLI tools (inspect_document, get_node, create_node, set_properties, batch, run_command, export, screenshot, save_file, open_file, pointer, key, type_text, select, undo, redo, etc.), figcraft-mcp injects 3 specialized tools:

Anti-Slop UI Design Standards

Every agent using figcraft-mcp is guided by the bundled anti-slop-ui skill and rules/AGENTS.md:

Environment Variables

Contributing & Community

Contributions, icon additions, and Anti-Slop UI component recipes are welcome!

• Read the Contributing Guide to get started with local development and unit testing.

• Review the Roadmap and Changelog.

• For security reports, see our Security Policy.

License

Released under the MIT License.