convez.ai
MCP ServerAutomaçãoAvançado
HelloVass

HelloVass Figma MCP Server

HelloVass/hellovass-figma-mcp

Converta designs do Figma em IR para geração automática de código multiplataforma

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que converte designs do Figma em representações intermediárias (IR) agnósticas de plataforma, facilitando a geração de código para Android, web e outros alvos. Fornece ferramentas para extrair árvores de componentes, capturar screenshots, baixar assets e acessar dados brutos do Figma.

Instalação

$npx convez-ai HelloVass/hellovass-figma-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 semanas
Versão
v0.1.7
Issues abertas
0
Contribuidores
2

Casos de uso

  • Converter designs Figma em código Android Compose
  • Extrair estrutura de componentes para geração de código web
  • Automatizar fluxo de design-to-code com agents Claude
  • Recuperar e validar assets de designs (imagens, SVGs, PDFs)

Veredito

Ferramenta especializada e bem estruturada para bridge design-to-code, com suporte robusto a múltiplas plataformas. Exige Java 17+ e token Figma, mas oferece pipeline completo (IR + assets + validação) superior às alternativas simples de integração.

README

A tradução para o português deste README ainda está na fila.

hellovass-figma-mcp

中文 | English

这是 HelloVass Figma MCP Server 的公开分发仓。

这里发布经过 R8 classfile 混淆的可运行 jar、checksum、JBang catalog 和 MCP 使用说明。

当前版本

前置条件

  • Java 17 或更高版本。
  • Figma Personal Access Token,并授予 File content read、File images read 权限。

MCP 客户端配置

推荐通过 JBang alias 启动。Codex / Claude Code / Claude Desktop 的 MCP 配置可以写成:

{
  "mcpServers": {
    "hellovass-figma": {
      "command": "jbang",
      "args": [
        "hellovass-figma@HelloVass/hellovass-figma-mcp"
      ],
      "env": {
        "FIGMA_TOKEN": "figd_xxx"
      }
    }
  }
}

也可以下载 jar 后使用本地 jar 启动:

{
  "mcpServers": {
    "hellovass-figma": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/hellovass-figma-mcp-0.1.3-all-r8.jar"
      ],
      "env": {
        "FIGMA_TOKEN": "figd_xxx"
      }
    }
  }
}

FIGMA_TOKEN 也可以由 MCP client 的环境变量管理;不要把真实 token 提交到仓库。JBang 启动会读取本仓的 jbang-catalog.json,catalog 指向当前 public R8 jar。

Tools

Tool参数说明
figma_get_view_treefigmaUrl主工具。把 Figma 节点转换为平台无关的 ViewTree IR JSON。
figma_get_screenshotfigmaUrl, scale?获取目标节点截图和截图元数据。
figma_download_assetsfileUrl, assets, outputDir下载 IR 中声明的图片、SVG、Android Vector、PDF 等资源。
figma_list_framesfileUrl列出 Figma 文件里的 page 和顶层 frame/component。
figma_get_node_rawfigmaUrl返回 Figma REST nodes endpoint 原始 JSON,用于定位 IR 转换问题。

使用方式

配置 MCP 后,把 Figma URL 交给支持 MCP 的 agent,让它调用 figma_get_view_tree 获取 IR,再按目标平台生成代码。

如果需要排查还原问题,可以让 agent 继续调用 figma_get_node_raw、figma_get_screenshot 和 figma_download_assets,对比原始节点、IR、截图和导出的资源。

Android 推荐搭配

如果目标是 Android Compose,推荐同时安装 HelloVass/svg2vector-skills。

这个 skill 提供 svg2vector CLI,封装 Android Studio Vector Asset Studio 内部使用的 Svg2Vector 算法,可以把 MCP 下载到本地的 SVG 资产转换成 Android VectorDrawable XML。

它不是 MCP server 的运行前置条件;但在 Android 还原链路里,它可以让 agent 优先把图标和可矢量化资源落成 res/drawable/*.xml,减少不必要的 PNG fallback,整体还原和工程落地会更稳定。

产物校验

shasum -a 256 hellovass-figma-mcp-0.1.3-all-r8.jar
cat hellovass-figma-mcp-0.1.3-all-r8.jar.sha256

两个 SHA-256 值一致时,说明 jar 没有被篡改或损坏。

Ver o original no GitHub

Bom para

Relacionados