@muloka/figma-console-mcp 0.3.0 → 0.4.0

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.
Files changed (34) hide show
  1. package/README.md +29 -13
  2. package/dist/apps/design-system-dashboard/mcp-app.html +521 -0
  3. package/dist/apps/token-browser/mcp-app.html +410 -0
  4. package/dist/cloudflare/core/figma-tools.js +64 -13
  5. package/dist/cloudflare/core/tokens-tools.js +1 -1
  6. package/dist/cloudflare/core/websocket-server.js +60 -7
  7. package/dist/cloudflare/index.js +3 -3
  8. package/dist/core/port-discovery.d.ts.map +1 -1
  9. package/dist/core/port-discovery.js +101 -20
  10. package/dist/core/port-discovery.js.map +1 -1
  11. package/dist/core/websocket-server.d.ts +18 -1
  12. package/dist/core/websocket-server.d.ts.map +1 -1
  13. package/dist/core/websocket-server.js +43 -2
  14. package/dist/core/websocket-server.js.map +1 -1
  15. package/dist/core/write-tools.d.ts.map +1 -1
  16. package/dist/core/write-tools.js +34 -0
  17. package/dist/core/write-tools.js.map +1 -1
  18. package/dist/local.d.ts.map +1 -1
  19. package/dist/local.js +7 -3
  20. package/dist/local.js.map +1 -1
  21. package/figma-desktop-bridge/ui.html +66 -5
  22. package/package.json +1 -1
  23. package/dist/browser/base.d.ts +0 -58
  24. package/dist/browser/base.d.ts.map +0 -1
  25. package/dist/browser/base.js +0 -6
  26. package/dist/browser/base.js.map +0 -1
  27. package/dist/browser/local.d.ts +0 -87
  28. package/dist/browser/local.d.ts.map +0 -1
  29. package/dist/browser/local.js +0 -318
  30. package/dist/browser/local.js.map +0 -1
  31. package/dist/core/figma-desktop-connector.d.ts +0 -312
  32. package/dist/core/figma-desktop-connector.d.ts.map +0 -1
  33. package/dist/core/figma-desktop-connector.js +0 -1298
  34. package/dist/core/figma-desktop-connector.js.map +0 -1
package/README.md CHANGED
@@ -1,20 +1,36 @@
1
- # Figma Console MCP Server
1
+ # @muloka/figma-console-mcp
2
2
 
3
- > ### 🍴 This is a fork
4
- >
5
- > **`@muloka/figma-console-mcp`** is a fork of [southleft/figma-console-mcp](https://github.com/southleft/figma-console-mcp) with a few agent-focused adjustments not yet in upstream:
6
- >
7
- > - **Streamable HTTP transport** in local mode — connect multiple local clients to one running instance ([upstream #48](https://github.com/southleft/figma-console-mcp/issues/48))
8
- > - **`VariableID:` alias support** in `figma_batch_create_variables` and `figma_setup_design_tokens` ([upstream #52](https://github.com/southleft/figma-console-mcp/issues/52))
9
- > - **Bridge robustness** — handler timeout + dropped-response logging in the Desktop Bridge dispatch ([upstream #94](https://github.com/southleft/figma-console-mcp/issues/94))
10
- >
11
- > **Install this fork:** `npx @muloka/figma-console-mcp` — the `npx figma-console-mcp` commands below install *upstream* instead. Versioned independently starting at `0.1.0`; currently tracking upstream **v1.35.0**. Everything else in this README is upstream's documentation and applies as written.
3
+ > An independently maintained fork of [southleft/figma-console-mcp](https://github.com/southleft/figma-console-mcp).
12
4
 
13
- [![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io/)
14
5
  [![npm](https://img.shields.io/npm/v/@muloka/figma-console-mcp)](https://www.npmjs.com/package/@muloka/figma-console-mcp)
6
+ [![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io/)
15
7
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
16
- [![Documentation](https://img.shields.io/badge/docs-docs.figma--console--mcp.southleft.com-0D9488)](https://docs.figma-console-mcp.southleft.com)
17
- [![Sponsor](https://img.shields.io/badge/Sponsor-southleft-ea4aaa?logo=github-sponsors&logoColor=white)](https://github.com/sponsors/southleft)
8
+
9
+ **Install:** `npx @muloka/figma-console-mcp` — the `npx figma-console-mcp` commands in the upstream documentation below install *upstream* instead. Versioned independently on a `0.x` line.
10
+
11
+ ## What this fork changes
12
+
13
+ - **Honest error reporting** — the eight single-op variable/collection/mode write tools check the bridge's result envelope, so a plugin-side failure surfaces its real error text instead of a false success or a masking TypeError
14
+ - **Streamable HTTP transport** in local mode — connect multiple local clients to one running instance ([upstream #48](https://github.com/southleft/figma-console-mcp/issues/48))
15
+ - **`VariableID:` alias support** in `figma_batch_create_variables` and `figma_setup_design_tokens` ([upstream #52](https://github.com/southleft/figma-console-mcp/issues/52))
16
+ - **Bridge robustness** — handler timeout + dropped-response logging in the Desktop Bridge dispatch ([upstream #94](https://github.com/southleft/figma-console-mcp/issues/94))
17
+ - **`page`/`pageSize` honored in `figma_get_variables` `format: "full"`** ([upstream #98](https://github.com/southleft/figma-console-mcp/issues/98))
18
+ - **Plugin + server build versions surfaced** in the Desktop Bridge UI and diagnostics
19
+ - **CI** — Node 22/24 test matrix with a per-file typecheck ratchet
20
+
21
+ ## Relationship to upstream
22
+
23
+ - Frozen at the upstream **v1.36.0** base — this fork does **not** track upstream releases.
24
+ - Upstream fixes are cherry-picked selectively when they matter to this fork's use cases, with original authorship preserved (so far: the v1.38.2 orphan-reaper fix and the v1.39.1 plugin-update-banner direction fix).
25
+ - Bugs and requests for this fork go to [this repo's issue tracker](https://github.com/muloka/figma-console-mcp/issues) — do not file them upstream.
26
+ - The hosted `*.southleft.com` endpoints referenced in the documentation below are upstream's service, not this fork's.
27
+ - Upstream's docs site and sponsorship: [![Documentation](https://img.shields.io/badge/docs-docs.figma--console--mcp.southleft.com-0D9488)](https://docs.figma-console-mcp.southleft.com) [![Sponsor](https://img.shields.io/badge/Sponsor-southleft-ea4aaa?logo=github-sponsors&logoColor=white)](https://github.com/sponsors/southleft)
28
+
29
+ ---
30
+
31
+ # Figma Console MCP Server
32
+
33
+ *Upstream documentation as of the v1.36.0 base — applies as written.*
18
34
 
19
35
  > **Your design system as an API.** Model Context Protocol server that bridges design and development—giving AI assistants complete access to Figma for **extraction**, **creation**, **debugging**, and **bidirectional token sync**.
20
36