@mp3wizard/figma-console-mcp 1.21.2 → 1.22.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -9
- package/dist/apps/design-system-dashboard/mcp-app.html +59 -59
- package/dist/apps/token-browser/mcp-app.html +53 -53
- package/dist/cloudflare/core/accessibility-tools.js +306 -0
- package/dist/cloudflare/core/cloud-websocket-connector.js +11 -0
- package/dist/cloudflare/core/design-code-tools.js +160 -2
- package/dist/cloudflare/core/figma-desktop-connector.js +2 -0
- package/dist/cloudflare/core/websocket-connector.js +11 -0
- package/dist/cloudflare/core/write-tools.js +49 -4
- package/dist/cloudflare/index.js +16 -7
- package/dist/core/accessibility-tools.d.ts +21 -0
- package/dist/core/accessibility-tools.d.ts.map +1 -0
- package/dist/core/accessibility-tools.js +307 -0
- package/dist/core/accessibility-tools.js.map +1 -0
- package/dist/core/design-code-tools.d.ts.map +1 -1
- package/dist/core/design-code-tools.js +160 -2
- package/dist/core/design-code-tools.js.map +1 -1
- package/dist/core/figma-connector.d.ts +1 -0
- package/dist/core/figma-connector.d.ts.map +1 -1
- package/dist/core/figma-desktop-connector.d.ts +1 -0
- package/dist/core/figma-desktop-connector.d.ts.map +1 -1
- package/dist/core/figma-desktop-connector.js +2 -0
- package/dist/core/figma-desktop-connector.js.map +1 -1
- package/dist/core/types/design-code.d.ts +8 -0
- package/dist/core/types/design-code.d.ts.map +1 -1
- package/dist/core/websocket-connector.d.ts +1 -0
- package/dist/core/websocket-connector.d.ts.map +1 -1
- package/dist/core/websocket-connector.js +11 -0
- package/dist/core/websocket-connector.js.map +1 -1
- package/dist/core/write-tools.d.ts.map +1 -1
- package/dist/core/write-tools.js +49 -4
- package/dist/core/write-tools.js.map +1 -1
- package/dist/local.d.ts.map +1 -1
- package/dist/local.js +52 -4
- package/dist/local.js.map +1 -1
- package/figma-desktop-bridge/code.js +1134 -1
- package/figma-desktop-bridge/ui-full.html +13 -0
- package/figma-desktop-bridge/ui.html +13 -0
- package/package.json +5 -101
package/README.md
CHANGED
|
@@ -24,6 +24,7 @@ Figma Console MCP connects AI assistants (like Claude) to Figma, enabling:
|
|
|
24
24
|
- **🔧 Variable management** - Create, update, rename, and delete design tokens
|
|
25
25
|
- **⚡ Real-time monitoring** - Watch logs as plugins execute
|
|
26
26
|
- **📌 FigJam boards** - Create stickies, flowcharts, tables, and code blocks on collaborative boards
|
|
27
|
+
- **♿ Accessibility scanning** - 13 WCAG design checks, component scorecards, axe-core code scanning, design-to-code parity
|
|
27
28
|
- **☁️ Cloud Write Relay** - Web AI clients (Claude.ai, v0, Replit) can design in Figma via cloud pairing
|
|
28
29
|
- **🔄 Four ways to connect** - Remote SSE, Cloud Mode, NPX, or Local Git
|
|
29
30
|
|
|
@@ -54,9 +55,9 @@ Figma Console MCP connects AI assistants (like Claude) to Figma, enabling:
|
|
|
54
55
|
| Real-time monitoring (console, selection) | ✅ | ❌ | ❌ |
|
|
55
56
|
| Desktop Bridge plugin | ✅ | ✅ | ❌ |
|
|
56
57
|
| Requires Node.js | Yes | **No** | No |
|
|
57
|
-
| **Total tools available** | **
|
|
58
|
+
| **Total tools available** | **94+** | **43** | **22** |
|
|
58
59
|
|
|
59
|
-
> **Bottom line:** Remote SSE is **read-only** with ~38% of the tools. **Cloud Mode** unlocks write access from web AI clients without Node.js. NPX/Local Git gives the full
|
|
60
|
+
> **Bottom line:** Remote SSE is **read-only** with ~38% of the tools. **Cloud Mode** unlocks write access from web AI clients without Node.js. NPX/Local Git gives the full 94+ tools with real-time monitoring.
|
|
60
61
|
|
|
61
62
|
---
|
|
62
63
|
|
|
@@ -64,7 +65,7 @@ Figma Console MCP connects AI assistants (like Claude) to Figma, enabling:
|
|
|
64
65
|
|
|
65
66
|
**Best for:** Designers who want full AI-assisted design capabilities.
|
|
66
67
|
|
|
67
|
-
**What you get:** All
|
|
68
|
+
**What you get:** All 94+ tools including design creation, variable management, and component instantiation.
|
|
68
69
|
|
|
69
70
|
#### Prerequisites
|
|
70
71
|
|
|
@@ -159,7 +160,7 @@ Create a simple frame with a blue background
|
|
|
159
160
|
|
|
160
161
|
**Best for:** Developers who want to modify source code or contribute to the project.
|
|
161
162
|
|
|
162
|
-
**What you get:** Same
|
|
163
|
+
**What you get:** Same 94+ tools as NPX, plus full source code access.
|
|
163
164
|
|
|
164
165
|
#### Quick Setup
|
|
165
166
|
|
|
@@ -248,7 +249,7 @@ Ready for design creation? Follow the [NPX Setup](#-npx-setup-recommended) guide
|
|
|
248
249
|
|
|
249
250
|
**Best for:** Using Claude.ai, v0, Replit, or Lovable to create and modify Figma designs — no Node.js required.
|
|
250
251
|
|
|
251
|
-
**What you get:**
|
|
252
|
+
**What you get:** 83 tools including full write access — design creation, variable management, component instantiation, and all REST API tools. Only real-time monitoring (console logs, selection tracking, document changes) requires Local Mode.
|
|
252
253
|
|
|
253
254
|
#### Prerequisites
|
|
254
255
|
|
|
@@ -305,7 +306,7 @@ AI Client → Cloud MCP Server → Durable Object Relay → Desktop Bridge Plugi
|
|
|
305
306
|
| Feature | NPX (Recommended) | Cloud Mode | Local Git | Remote SSE |
|
|
306
307
|
|---------|-------------------|------------|-----------|------------|
|
|
307
308
|
| **Setup time** | ~10 minutes | ~5 minutes | ~15 minutes | ~2 minutes |
|
|
308
|
-
| **Total tools** | **
|
|
309
|
+
| **Total tools** | **94+** | **43** | **94+** | **22** (read-only) |
|
|
309
310
|
| **Design creation** | ✅ | ✅ | ✅ | ❌ |
|
|
310
311
|
| **Variable management** | ✅ | ✅ | ✅ | ❌ |
|
|
311
312
|
| **Component instantiation** | ✅ | ✅ | ✅ | ❌ |
|
|
@@ -320,7 +321,7 @@ AI Client → Cloud MCP Server → Durable Object Relay → Desktop Bridge Plugi
|
|
|
320
321
|
| **Automatic updates** | ✅ (`@latest`) | ✅ | Manual (`git pull`) | ✅ |
|
|
321
322
|
| **Source code access** | ❌ | ❌ | ✅ | ❌ |
|
|
322
323
|
|
|
323
|
-
> **Key insight:** Remote SSE is read-only. Cloud Mode adds write access for web AI clients without Node.js. NPX/Local Git give the full
|
|
324
|
+
> **Key insight:** Remote SSE is read-only. Cloud Mode adds write access for web AI clients without Node.js. NPX/Local Git give the full 94+ tools.
|
|
324
325
|
|
|
325
326
|
**📖 [Complete Feature Comparison](docs/mode-comparison.md)**
|
|
326
327
|
|
|
@@ -654,7 +655,7 @@ The **Figma Desktop Bridge** plugin is the recommended way to connect Figma to t
|
|
|
654
655
|
- The MCP server communicates via **WebSocket** through the Desktop Bridge plugin
|
|
655
656
|
- The server tries port 9223 first, then automatically falls back through ports 9224–9232 if needed
|
|
656
657
|
- The plugin scans all ports in the range and connects to every active server it finds
|
|
657
|
-
- All
|
|
658
|
+
- All 94+ tools work through the WebSocket transport
|
|
658
659
|
|
|
659
660
|
**Multiple files:** The WebSocket server supports multiple simultaneous plugin connections — one per open Figma file. Each connection is tracked by file key with independent state (selection, document changes, console logs).
|
|
660
661
|
|
|
@@ -791,7 +792,7 @@ The architecture supports adding new apps with minimal boilerplate — each app
|
|
|
791
792
|
|
|
792
793
|
## 🛤️ Roadmap
|
|
793
794
|
|
|
794
|
-
**Current Status:** v1.17.0 (Stable) - Production-ready with FigJam + Slides support, Cloud Write Relay, Design System Kit, WebSocket-only connectivity, smart multi-file tracking,
|
|
795
|
+
**Current Status:** v1.17.0 (Stable) - Production-ready with FigJam + Slides support, Cloud Write Relay, Design System Kit, WebSocket-only connectivity, smart multi-file tracking, 94+ tools, Comments API, and MCP Apps
|
|
795
796
|
|
|
796
797
|
**Recent Releases:**
|
|
797
798
|
- [x] **v1.17.0** - Figma Slides Support: 15 new tools for managing presentations — slides, transitions, content, reordering, and navigation. Inspired by Toni Haidamous (PR #11).
|