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 GitHubServidor 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-mcp1 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
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
这是 HelloVass Figma MCP Server 的公开分发仓。
这里发布经过 R8 classfile 混淆的可运行 jar、checksum、JBang catalog 和 MCP 使用说明。
当前版本
- Version:
0.1.3 - Jar:
hellovass-figma-mcp-0.1.3-all-r8.jar - Checksum:
hellovass-figma-mcp-0.1.3-all-r8.jar.sha256 - SHA-256:
1d68d4e13d162e4d7a0b6ed67c6afa7a7243c3715d5e5a51654dd4c7333ac5c1
前置条件
- 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_tree | figmaUrl | 主工具。把 Figma 节点转换为平台无关的 ViewTree IR JSON。 |
figma_get_screenshot | figmaUrl, scale? | 获取目标节点截图和截图元数据。 |
figma_download_assets | fileUrl, assets, outputDir | 下载 IR 中声明的图片、SVG、Android Vector、PDF 等资源。 |
figma_list_frames | fileUrl | 列出 Figma 文件里的 page 和顶层 frame/component。 |
figma_get_node_raw | figmaUrl | 返回 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 没有被篡改或损坏。