@vkhanhqui/figma-mcp-go 0.0.1 → 0.0.2-alpha

package/README.md

@@ -0,0 +1,127 @@
+# figma-mcp-go
+
+Figma MCP Server Without API Rate Limits
+
+A free, open-source Figma MCP server that reads Figma files directly via plugin — no REST API, no rate limits. Works with Cursor, Claude, GitHub Copilot, and any MCP-compatible AI tool.
+
+**Highlights**
+- No Figma API token required
+- No rate limits — free plan friendly
+- Reads live Figma data via plugin bridge
+- Written in Go, distributed via npm
+- Supports multiple AI tools simultaneously
+
+---
+
+## Why this exists
+
+Most Figma MCP servers rely on the **Figma REST API**.
+
+That sounds fine… until you hit this:
+
+| Plan | Limit |
+|------|-------|
+| Starter / View / Collab | **6 tool calls/month** |
+| Pro / Org (Dev seat) | 200 tool calls/day |
+| Enterprise | 600 tool calls/day |
+
+If you're experimenting with AI tools, you'll burn through that in minutes.
+
+I didn't have enough money to pay for higher limits.
+So I built something that **doesn't use the API at all**.
+
+---
+
+## Installation & Setup
+
+Install via `npx` — no build step required. Watch the setup video or follow the steps below.
+
+[![Watch the video](https://img.youtube.com/vi/DjqyU0GKv9k/sddefault.jpg)](https://youtu.be/DjqyU0GKv9k)
+
+### 1. Configure your AI tool
+
+**.vscode/mcp.json** (Cursor / VS Code / GitHub Copilot)
+```json
+{
+  "servers": {
+    "figma-mcp-go": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "@vkhanhqui/figma-mcp-go"
+      ]
+    }
+  }
+}
+```
+
+**.mcp.json** (Claude and other MCP-compatible tools)
+```json
+{
+  "mcpServers": {
+    "figma-mcp-go": {
+      "command": "npx",
+      "args": ["-y", "@vkhanhqui/figma-mcp-go"]
+    }
+  }
+}
+```
+
+### 2. Install the Figma plugin
+
+1. In Figma Desktop: **Plugins → Development → Import plugin from manifest**
+2. Select `manifest.json` from the [plugin.zip](https://github.com/vkhanhqui/figma-mcp-go/releases)
+3. Run the plugin inside any Figma file
+
+---
+
+## Available Tools
+
+### Document & Selection
+
+| Tool | Description |
+|------|-------------|
+| `get_document` | Full current page tree |
+| `get_metadata` | File name, pages, current page |
+| `get_pages` | All pages (IDs + names) — lightweight, no tree loading |
+| `get_selection` | Currently selected nodes |
+| `get_node` | Single node by ID |
+| `get_nodes_info` | Multiple nodes by ID |
+| `get_design_context` | Depth-limited tree with `detail` level (`minimal`/`compact`/`full`) |
+| `search_nodes` | Find nodes by name substring and/or type within a subtree |
+| `scan_text_nodes` | All text nodes in a subtree |
+| `scan_nodes_by_types` | Nodes matching given type list |
+| `get_viewport` | Current viewport center, zoom, and visible bounds |
+
+### Styles & Variables
+
+| Tool | Description |
+|------|-------------|
+| `get_styles` | Paint, text, effect, and grid styles |
+| `get_variable_defs` | Variable collections and values |
+| `get_local_components` | All components + component sets with variant properties |
+| `get_annotations` | Dev-mode annotations |
+| `get_fonts` | All fonts used on the current page, sorted by frequency |
+| `get_reactions` | Prototype/interaction reactions on a node |
+
+### Export
+
+| Tool | Description |
+|------|-------------|
+| `get_screenshot` | Base64 image export of any node |
+| `save_screenshots` | Export images to disk (server-side, no API call) |
+
+---
+
+## Related Projects
+
+- [magic-spells/figma-mcp-bridge](https://github.com/magic-spells/figma-mcp-bridge)
+- [grab/cursor-talk-to-figma-mcp](https://github.com/grab/cursor-talk-to-figma-mcp)
+- [gethopp/figma-mcp-bridge](https://github.com/gethopp/figma-mcp-bridge)
+
+---
+
+## Contributing
+
+Issues and PRs are welcome.

package/bin/run.js

@@ -5,8 +5,19 @@ const { spawnSync } = require('node:child_process');
 const { existsSync } = require('node:fs');
 const path = require('node:path');
 
+const PLATFORM_MAP = { darwin: 'darwin', linux: 'linux', win32: 'windows' };
+const ARCH_MAP = { x64: 'amd64', arm64: 'arm64' };
+
+const goos = PLATFORM_MAP[process.platform];
+const goarch = ARCH_MAP[process.arch];
+
+if (!goos || !goarch) {
+  process.stderr.write(`[figma-mcp-go] Unsupported platform: ${process.platform}/${process.arch}\n`);
+  process.exit(1);
+}
+
 const binaryName = process.platform === 'win32' ? 'figma-mcp-go.exe' : 'figma-mcp-go';
-const binaryPath = path.join(__dirname, binaryName);
+const binaryPath = path.join(__dirname, `${goos}-${goarch}`, binaryName);
 
 if (!existsSync(binaryPath)) {
   process.stderr.write(

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "@vkhanhqui/figma-mcp-go",
-  "version": "0.0.1",
+  "version": "0.0.2-alpha",
   "description": "A zero-cost, unlimited Figma MCP server — no API key, no rate limits",
   "mcpName": "io.github.vkhanhqui/figma-mcp-go",
   "bin": {
     "figma-mcp-go": "bin/run.js"
   },
-  "scripts": {
-    "postinstall": "node scripts/install.js"
-  },
   "files": [
     "bin/run.js",
-    "scripts"
+    "bin/darwin-amd64/",
+    "bin/darwin-arm64/",
+    "bin/linux-amd64/",
+    "bin/linux-arm64/",
+    "bin/windows-amd64/",
+    "bin/windows-arm64/"
   ],
   "keywords": [
     "figma",

package/scripts/install.js

@@ -1,96 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const https = require('node:https');
-const fs = require('node:fs');
-const path = require('node:path');
-const { execFileSync } = require('node:child_process');
-const os = require('node:os');
-
-const pkg = require('../package.json');
-const version = pkg.version;
-
-const PLATFORM_MAP = {
-  darwin: 'darwin',
-  linux: 'linux',
-  win32: 'windows',
-};
-
-const ARCH_MAP = {
-  x64: 'amd64',
-  arm64: 'arm64',
-};
-
-const goos = PLATFORM_MAP[process.platform];
-const goarch = ARCH_MAP[process.arch];
-
-if (!goos || !goarch) {
-  console.error(`[figma-mcp-go] Unsupported platform: ${process.platform}/${process.arch}`);
-  process.exit(1);
-}
-
-const isWindows = goos === 'windows';
-const binaryName = isWindows ? 'figma-mcp-go.exe' : 'figma-mcp-go';
-const ext = isWindows ? '.zip' : '.tar.gz';
-const archiveName = `figma-mcp-go_${goos}_${goarch}${ext}`;
-const downloadUrl = `https://github.com/vkhanhqui/figma-mcp-go/releases/download/v${version}/${archiveName}`;
-const binDir = path.join(__dirname, '..', 'bin');
-const tmpFile = path.join(os.tmpdir(), archiveName);
-
-function download(url, dest) {
-  return new Promise((resolve, reject) => {
-    const file = fs.createWriteStream(dest);
-    function get(u) {
-      https.get(u, (res) => {
-        if (res.statusCode === 301 || res.statusCode === 302) {
-          return get(res.headers.location);
-        }
-        if (res.statusCode !== 200) {
-          file.close();
-          fs.rmSync(dest, { force: true });
-          reject(new Error(`HTTP ${res.statusCode} downloading ${u}`));
-          return;
-        }
-        res.pipe(file);
-        file.on('finish', () => file.close(resolve));
-        file.on('error', reject);
-      }).on('error', reject);
-    }
-    get(url);
-  });
-}
-
-async function main() {
-  console.log(`[figma-mcp-go] Downloading ${archiveName}...`);
-
-  try {
-    await download(downloadUrl, tmpFile);
-  } catch (err) {
-    console.error(`[figma-mcp-go] Failed to download: ${err.message}`);
-    console.error(`[figma-mcp-go] URL: ${downloadUrl}`);
-    process.exit(1);
-  }
-
-  fs.mkdirSync(binDir, { recursive: true });
-
-  try {
-    if (isWindows) {
-      execFileSync('powershell', [
-        '-NoProfile', '-Command',
-        `Expand-Archive -Force -Path "${tmpFile}" -DestinationPath "${binDir}"`,
-      ]);
-    } else {
-      execFileSync('tar', ['xzf', tmpFile, '-C', binDir, binaryName]);
-      fs.chmodSync(path.join(binDir, binaryName), 0o755);
-    }
-  } catch (err) {
-    console.error(`[figma-mcp-go] Failed to extract: ${err.message}`);
-    process.exit(1);
-  } finally {
-    fs.rmSync(tmpFile, { force: true });
-  }
-
-  console.log('[figma-mcp-go] Installed successfully.');
-}
-
-main();