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

package/README.md

@@ -1,15 +1,17 @@
 # figma-mcp-go
 
-Figma MCP Server Without API Rate Limits
+Figma MCP — Free, No 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.
+Open-source Figma MCP server with full read/write access via plugin — no REST API, no rate limits. Turn text into designs and designs into real code. 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
+- **Read and Write** live Figma data via plugin bridge
 - Supports multiple AI tools simultaneously
+- Written in Go, distributed via npm
+
+https://github.com/user-attachments/assets/17bda971-0e83-4f18-8758-8ac2b8dcba62
 
 ---
 
@@ -40,29 +42,34 @@ Install via `npx` — no build step required. Watch the setup video or follow th
 
 ### 1. Configure your AI tool
 
-**.vscode/mcp.json** (Cursor / VS Code / GitHub Copilot)
+**Claude Code CLI**
+```bash
+claude mcp add -s project figma-mcp-go -- npx -y @vkhanhqui/figma-mcp-go@latest
+```
+
+**.mcp.json** (Claude and other MCP-compatible tools)
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "figma-mcp-go": {
-      "type": "stdio",
       "command": "npx",
-      "args": [
-        "-y",
-        "@vkhanhqui/figma-mcp-go"
-      ]
+      "args": ["-y", "@vkhanhqui/figma-mcp-go"]
     }
   }
 }
 ```
 
-**.mcp.json** (Claude and other MCP-compatible tools)
+**.vscode/mcp.json** (Cursor / VS Code / GitHub Copilot)
 ```json
 {
-  "mcpServers": {
+  "servers": {
     "figma-mcp-go": {
+      "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@vkhanhqui/figma-mcp-go"]
+      "args": [
+        "-y",
+        "@vkhanhqui/figma-mcp-go"
+      ]
     }
   }
 }
@@ -78,6 +85,34 @@ Install via `npx` — no build step required. Watch the setup video or follow th
 
 ## Available Tools
 
+### Write — Create
+
+| Tool | Description |
+|------|-------------|
+| `create_frame` | Create a frame with optional auto-layout, fill, and parent |
+| `create_rectangle` | Create a rectangle with optional fill and corner radius |
+| `create_ellipse` | Create an ellipse or circle |
+| `create_text` | Create a text node (font loaded automatically) |
+| `import_image` | Decode base64 image and place it as a rectangle fill |
+
+### Write — Modify
+
+| Tool | Description |
+|------|-------------|
+| `set_text` | Update text content of an existing TEXT node |
+| `set_fills` | Set solid fill color (hex) on a node |
+| `set_strokes` | Set solid stroke color and weight on a node |
+| `move_nodes` | Move nodes to an absolute x/y position |
+| `resize_nodes` | Resize nodes by width and/or height |
+| `rename_node` | Rename a node |
+| `clone_node` | Clone a node, optionally repositioning or reparenting |
+
+### Write — Delete
+
+| Tool | Description |
+|------|-------------|
+| `delete_nodes` | Delete one or more nodes permanently |
+
 ### Document & Selection
 
 | Tool | Description |
@@ -112,6 +147,17 @@ Install via `npx` — no build step required. Watch the setup video or follow th
 | `get_screenshot` | Base64 image export of any node |
 | `save_screenshots` | Export images to disk (server-side, no API call) |
 
+### MCP Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `read_design_strategy` | Best practices for reading Figma designs |
+| `design_strategy` | Best practices for creating and modifying designs |
+| `text_replacement_strategy` | Chunked approach for replacing text across a design |
+| `annotation_conversion_strategy` | Convert manual annotations to native Figma annotations |
+| `swap_overrides_instances` | Transfer overrides between component instances |
+| `reaction_to_connector_strategy` | Map prototype reactions into interaction flow diagrams |
+
 ---
 
 ## Related Projects

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkhanhqui/figma-mcp-go",
-  "version": "0.0.2-alpha",
+  "version": "0.0.3-alpha",
   "description": "A zero-cost, unlimited Figma MCP server — no API key, no rate limits",
   "mcpName": "io.github.vkhanhqui/figma-mcp-go",
   "bin": {