Figma Local MCP Bridge
Provides local read-only access to Figma Desktop files through a Figma plugin and WebSocket bridge, enabling inspection of the current selection and node scene graphs, page structure, styles, variables/design tokens, components and variants, node search, and export of nodes as PNG, JPG, or SVG for design-to-code handoff.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Figma Local MCP Bridge
Servidor MCP local + Plugin para Figma Desktop conectado diretamente via WebSocket (ws://localhost:3055), sem depender da REST API web (api.figma.com), sem token da API e sem limites de requisição.
Projetado especificamente para Dev Handoff (somente leitura): a IA lê o Scene Graph completo da seleção atual, CSS nativo (getCSSAsync), estilos, variáveis/design tokens resolvidos e imagens/SVGs exportados para gerar código fiel ao layout.
Arquitetura
Zero chamadas HTTP para
api.figma.com: tudo roda localmente na memória do Figma Desktop e trafega em loopback (localhost:3055—127.0.0.1/::1).Auto-eleição Leader / Follower (
src/bridge.ts): o primeiro processo MCP aberto pelo cliente (Antigravity, Claude Code, etc.) sobe o servidor WebSocket na porta3055(leader). Outras janelas ou clientes abertos ao mesmo tempo entram comofollowerno mesmo socket — e se o líder fechar, o próximo assume a liderança automaticamente.Suporte a múltiplas abas do Figma: roteia automaticamente para a aba ativa mais recente ou permite especificar o parâmetro
filenas ferramentas.
Related MCP server: finish-line
Pré-requisitos
Node.js 18+
Figma Desktop instalado (não funciona no Figma Web/navegador, pois a importação de plugins locais via
manifest.jsonsó existe no app Desktop).
Passo 1 — Clonar e compilar
git clone <url-do-repositorio> figma-bridge
cd figma-bridge
npm install
npm run build
pwdImportante:
npm run buildgerabuild/index.js(servidor MCP) eplugin/code.js(código do plugin), ambos ignorados no.gitignore. Rode esse comando antes de importar o plugin no Figma. Guarde a saída dopwdpara usar nos caminhos abaixo.
Passo 2 — Configurar o MCP no seu cliente
Dica (
nvm): se você usanvm, descubra o caminho absoluto do binário comwhich nodee use-o no lugar de"node", pois aplicativos GUI/desktop nem sempre carregam o$PATHdo seu shell.
Antigravity
Abra o arquivo de configuração global
~/.gemini/config/mcp_config.json.Adicione a entrada
"figma"dentro de"mcpServers"(substituindo/caminho/absoluto/para/figma-bridgepela saída dopwd):
{
"mcpServers": {
"figma": {
"command": "node",
"args": [
"/caminho/absoluto/para/figma-bridge/build/index.js"
]
}
}
}No Antigravity, recarregue os servidores em Additional Options (
...) > MCP Servers (ou reinicie a sessão).
Claude Code
Você pode conectar via CLI ou editando o JSON manualmente:
Opção 1 — Via CLI
Global (disponível em todos os projetos —
--scope user):
claude mcp add --transport stdio --scope user figma -- node /caminho/absoluto/para/figma-bridge/build/index.jsApenas no projeto atual (cria
.mcp.json—--scope project):
claude mcp add --transport stdio --scope project figma -- node /caminho/absoluto/para/figma-bridge/build/index.jsOpção 2 — Configuração manual em JSON
Adicione ao .mcp.json na raiz do projeto (ou em mcpServers dentro de ~/.claude.json):
{
"mcpServers": {
"figma": {
"command": "node",
"args": [
"/caminho/absoluto/para/figma-bridge/build/index.js"
]
}
}
}Para confirmar que conectou no Claude Code, rode claude mcp list no terminal ou digite /mcp dentro de uma sessão ativa.
Uso simultâneo: como o bridge usa eleição leader/follower, você pode manter Antigravity e Claude Code abertos ao mesmo tempo compartilhando a mesma janela do plugin no Figma Desktop, sem conflito de porta.
Passo 3 — Importar e executar o plugin no Figma Desktop
Abra o aplicativo Figma Desktop.
Abra qualquer arquivo de design (o menu de plugins não aparece na tela inicial Recents).
Aperte
Cmd + K(macOS) ouCtrl + K(Windows/Linux), digiteImport plugin from manifeste pressione Enter *(ou vá no menu Plugins > Development > Import plugin from manifest...)*.Selecione o arquivo
figma-bridge/plugin/manifest.json.Execute o plugin:
Cmd + K(ouCtrl + K) →Figma Local MCP Bridge.Aguarde até 2 segundos: o badge ficará verde (
Conectado :3055).Se aparecer
Servidor offline / Reconectando..., confira se o passo 2 foi carregado no Antigravity ou Claude Code — assim que o cliente MCP iniciar, o plugin conecta sozinho.Mantenha a janela do plugin aberta ou clique em Minimizar (encolhe para
240×40). Fechar noXencerra a execução do plugin.
Opcional: trocar a porta padrão (3055)
Se a porta 3055 já estiver ocupada, é preciso atualizar os 3 pontos abaixo:
No
mcp_config.json/.mcp.json, adicione"env": { "FIGMA_BRIDGE_PORT": "3056" }na entrada"figma".Em
plugin/manifest.json, atualizedevAllowedDomainspara["ws://localhost:3056", "http://localhost:3056"]e reimporte o manifest no Figma Desktop.Na interface do plugin, informe
3056no campo Porta WS e clique em Reconectar.
Como referenciar telas para a IA
Selecionar o frame no Figma: clique no título do frame/tela (ou na camada na aba Layers) e peça para a IA ler a seleção (
figma_get_selection).Citar o nome do frame ou página: peça pelo nome (ex: "Leia a tela Login na página Light Mode").
Colar o link da seleção (
Cmd + L/Ctrl + L): a IA extrai apenas onode-iddo link e consulta localmente viafigma_get_node, sem bater na API web.
Exemplos de uso (prompts)
Com o plugin conectado (Conectado :3055), peça diretamente no chat do Antigravity ou do Claude Code:
1. Gerar tela ou componente a partir da seleção atual
"Cria essa tela que está selecionada no Figma em React + Tailwind."
"Implementa esse componente selecionado no Figma usando HTML e CSS seguindo exatamente o Auto Layout, espaçamentos e cores."
"Lê a seleção atual no Figma, exporta um preview PNG para conferir o visual e cria a página em Next.js com componentes separados."
2. Usar o link copiado do Figma (Cmd + L / Ctrl + L)
"Analisa esse componente do Figma e cria ele em React Native:
https://www.figma.com/design/...?...&node-id=7342-2879"
3. Buscar por nome da tela ou página
"Lista todas as telas da página
Light Modee me mostra a estrutura da telaDashboard."
"Procura o frame
Bottom Navigationno arquivo aberto e gera o código dele com os ícones."
4. Extrair Design Tokens, Cores e Tipografia
"Extrai todas as variáveis e estilos desse arquivo Figma e gera um
tokens.csscom:roote modo escuro ([data-theme='dark'])."
"Lê as variáveis do Figma em formato DTCG e atualiza nosso
tailwind.configcom as cores, fontes e espaçamentos do Design System."
5. Exportar ícones SVG ou imagens
"Exporta todos os ícones da barra de navegação selecionada em SVG para a pasta
src/assets/icons/."
6. Quando houver mais de um arquivo aberto no Figma
"Lê a seleção do arquivo
Design Systemno Figma e compara com o componenteButtondo nosso projeto."
Ferramentas MCP expostas (10 tools)
Ferramenta | Descrição |
| Status do bridge ( |
| Nome do arquivo, páginas, frames de primeiro nível e resumo da seleção. |
| Scene Graph completo da seleção atual (Auto Layout, bounds, tipografia, fills, strokes, |
| Scene Graph completo para um ou mais |
| Outline leve da página atual ou específica ( |
| Busca nós por nome, texto ou tipo na seleção, página atual ou arquivo inteiro. |
| Todos os estilos locais (cores, tipografia, sombras/blurs, grids). |
| Collections, modes e variáveis locais com resolução recursiva de aliases ( |
| Catálogo de |
| Exporta um nó como |
Solução de problemas
Servidor offline / Reconectando...no plugin: recarregue os servidores MCP no Antigravity (Additional Options (...) > MCP Servers) ou verifique comclaude mcp listno Claude Code. Se usarnvm, troque"node"pelo caminho completo obtido comwhich node.Menu
Plugins > Developmentnão aparece no Figma: abra um arquivo de design primeiro (não funciona na tela inicial Recents) e certifique-se de estar usando o Figma Desktop, não o navegador.Erro ao importar
manifest.json/code.jsnão encontrado: rodenpm install && npm run buildna raiz do projeto antes de importar no Figma.Erro de conexão após trocar a porta: lembre-se de atualizar
devAllowedDomainsemplugin/manifest.jsonpara a nova porta e reimportar o manifest no Figma Desktop.
Desenvolvimento e testes
# Compilar servidor MCP + plugin do Figma
npm run build
# Executar suíte de testes E2E (inclui eleição leader/follower e failover)
npm testTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
The Figma MCP server brings Figma design context directly into your AI workflow.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Give AI agents your deeepSpace design system: components, tokens, styles and code mappings.
Serves your design system and coding standards to coding agents, so they stop guessing.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI coding assistants to draw UI directly on a Figma Desktop canvas and read existing designs back as structured JSON, tokens, CSS, and screenshots, all over a localhost bridge without external API keys.109 npm2MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to inspect Figma selections, navigate pages, render previews, generate starter code, and submit user-approved canvas edits through a local bridge.3 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables AI coding agents to inspect the currently selected Figma element or find layers by name, extracting layout, colors, typography, borders, and shadows as compact design tokens while exporting SVG and PNG assets straight into the local project. It connects over a local WebSocket to a running Figma session, so no API key, Dev Mode subscription, or manual ZIP export is required.-
- AlicenseAqualityBmaintenanceEnables AI coding agents to read and edit the file currently open in Figma Desktop through a local development plugin, supporting node inspection, JSON/image exports, and arbitrary Plugin API scripts without REST API rate limits.711 npmMIT