Skip to main content
Glama
deenesjakoruzh
gethopp

Figma MCP Bridge

by gethopp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Figma MCP Bridge

Pairing with Hopp

虽然已经存在其他出色的 Figma MCP 服务器，例如 Figma-Context-MCP，但一个问题是免费用户的 API 限制。

免费账户的限制是每月 6 次请求，没错，是每月。

Figma MCP Bridge 是解决此问题的方案。它是一个插件 + MCP 服务器，可以将实时 Figma 文档数据流式传输到 AI 工具，而不会触及 Figma API 的速率限制，因此它是属于我们普通人的 Figma MCP ✊

它支持同时连接多个 Figma 文件；在每个文件中打开插件，你的 AI 代理就可以通过 fileKey 查询其中任何一个。单文件设置的使用方式与之前完全相同，无需任何更改。

演示

观看在 Cursor 中使用 Figma MCP Bridge 构建 UI 的演示

观看视频

Related MCP server: Figma Bridge MCP

快速开始

1. 将 MCP 服务器添加到你最喜欢的 AI 工具中

将以下内容添加到你的 AI 工具的 MCP 配置中（例如 Cursor、Windsurf、Claude Desktop）：

{
  "figma-bridge": {
    "command": "npx",
    "args": ["-y", "@gethopp/figma-mcp-bridge"]
  }
}

就是这样——无需下载或安装任何二进制文件。

2. 添加 Figma 插件

从 最新发布 页面下载插件，然后在 Figma 中转到 Plugins > Development > Import plugin from manifest，并选择 plugin/ 文件夹中的 manifest.json 文件。

3. 开始使用 🎉

打开一个 Figma 文件，运行插件，然后开始向你的 AI 工具提问。MCP 服务器将自动连接到插件。

要跨多个文件工作，只需在每个 Figma 文件中打开插件即可。该桥接器会保持所有连接处于活动状态，你的 AI 代理可以通过 fileKey 定位其中任何一个。

如果你想了解更多关于它的工作原理，请阅读 工作原理 部分。

可用工具

工具

描述

list_files

列出所有已连接的 Figma 文件（支持多文件工作流）

get_document

获取当前 Figma 页面文档树

get_selection

获取 Figma 中当前选中的节点

get_node

通过 ID 获取特定的 Figma 节点（冒号格式，例如 4029:12345）

get_styles

获取所有本地填充、文本、效果和网格样式

get_metadata

获取文件名、页面和当前页面信息

get_design_context

获取一个深度受限的树，旨在优化对设计上下文的理解

get_variable_defs

获取所有变量集合、模式和值（设计令牌）

get_screenshot

将节点导出为 PNG/SVG/JPG/PDF（base64 编码）

save_screenshots

直接将截图导出并保存到本地文件系统

当连接了多个 Figma 文件时，所有工具都接受一个可选的 fileKey 参数。使用 list_files 来发现已连接的文件及其密钥。

本地开发

1. 在本地克隆此仓库

git clone git@github.com:gethopp/figma-mcp-bridge.git

2. 构建服务器

cd server && npm install && npm run build

3. 构建插件

cd plugin && bun install && bun run build

4. 将 MCP 服务器添加到你最喜欢的 AI 工具中

对于本地开发，请将以下内容添加到你的 AI 工具的 MCP 配置中：

{
  "figma-bridge": {
    "command": "node",
    "args": ["/path/to/figma-mcp-bridge/server/dist/index.js"]
  }
}

结构

Figma-MCP-Bridge/
├── plugin/   # Figma plugin (TypeScript/React)
└── server/   # MCP server (TypeScript/Node.js)
    └── src/
        ├── index.ts      # Entry point
        ├── bridge.ts     # WebSocket bridge to Figma plugin
        ├── leader.ts     # Leader: HTTP server + bridge
        ├── follower.ts   # Follower: proxies to leader via HTTP
        ├── node.ts       # Dynamic leader/follower role switching
        ├── election.ts   # Leader election & health monitoring
        ├── tools.ts      # MCP tool definitions
        └── types.ts      # Shared types

工作原理

Figma MCP Bridge 有两个主要组件：

1. Figma 插件

Figma 插件是 Figma MCP Bridge 的用户界面。你在想要使用 MCP 服务器的 Figma 文件中运行它，它负责为你获取所需的所有信息。

2. MCP 服务器

MCP 服务器是 Figma MCP Bridge 的核心。它维护一个以 fileKey 为键的 WebSocket 连接注册表，因此可以同时连接多个 Figma 文件。服务器负责：

  • 处理来自一个或多个 Figma 插件实例的 WebSocket 连接

  • 根据 fileKey 将工具调用路由到正确的文件

  • 将响应转发回 AI 客户端

  • 处理领导者选举（因为我们一次只能与一个 MCP 服务器建立一个 WS 连接）

┌─────────────────────────────────────────────────────────────────────────────┐
│                              FIGMA (Browser)                                │
│  ┌───────────────────────────────────────────────────────────────────────┐  │
│  │                         Figma Plugin                                  │  │
│  │                    (TypeScript/React)                                 │  │
│  └───────────────────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────────────────┘
                                      │
                                      │ WebSocket
                                      │ (ws://localhost:1994/ws)
                                      ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                          PRIMARY MCP SERVER                                 │
│                         (Leader on :1994)                                   │
│  ┌─────────────────────────────────────────────────────────────────────┐    │
│  │  Bridge                                    Endpoints:               │    │
│  │  • Manages WebSocket conn                  • /ws    (plugin)        │    │
│  │  • Forwards requests to plugin             • /ping  (health)        │    │
│  │  • Routes responses back                   • /rpc   (followers)     │    │
│  └─────────────────────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────────────────┘
                           ▲                              ▲
                           │ HTTP /rpc                    │ HTTP /rpc
                           │ POST requests                │ POST requests
                           │                              │
         ┌─────────────────┴───────────┐    ┌─────────────┴───────────────┐
         │    FOLLOWER MCP SERVER 1    │    │    FOLLOWER MCP SERVER 2    │
         │                             │    │                             │
         │  • Pings leader /ping       │    │  • Pings leader /ping       │
         │  • Forwards tool calls      │    │  • Forwards tool calls      │
         │    via HTTP /rpc            │    │    via HTTP /rpc            │
         │  • If leader dies →         │    │  • If leader dies →         │
         │    attempts takeover        │    │    attempts takeover        │
         └─────────────────────────────┘    └─────────────────────────────┘
                    ▲                                      ▲
                    │                                      │
                    │ MCP Protocol                         │ MCP Protocol
                    │ (stdio)                              │ (stdio)
                    ▼                                      ▼
         ┌─────────────────────────────┐    ┌─────────────────────────────┐
         │      AI Tool / IDE 1        │    │      AI Tool / IDE 2        │
         │      (e.g., Cursor)         │    │      (e.g., Cursor)         │
         └─────────────────────────────┘    └─────────────────────────────┘

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityActive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-figma

    tranhoangtu-it
    A
    license
    Not graded
    quality
    D
    maintenance
    Bridges AI clients to Figma Desktop via Plugin API and WebSocket, enabling real-time design manipulation without rate limits.
    1,213 npm
    MIT

  • figma-mcp-rust

    alvinindra
    A
    license
    Not graded
    quality
    A
    maintenance
    An MCP server that enables AI tools to read and write Figma designs via a plugin bridge, bypassing the Figma REST API and rate limits.
    61
    MIT

  • figma-meta-mcp

    shinjiyu
    A
    license
    A
    quality
    C
    maintenance
    Figma MCP server that lets agents execute arbitrary JavaScript inside a running Figma desktop app via a local development plugin, enabling real-time document inspection and manipulation while avoiding REST API rate limits.
    3
    MIT