figma-mcp-server

MCP-сервер (stdio) для чтения Figma через REST API: структура макетов, экспорт картинок, комментарии.

Для ИИ-агентов: AGENTS.md.

Быстрый старт

cp .env.example .env   # FIGMA_TOKEN=figd_...
npm install
npm run test:unit
npm run typecheck
npm run dev            # stdio MCP

Токен: Figma → Settings → Security → Personal access tokens
Scopes: file_content:read, для комментариев — file_comments:read.
PAT (figd_…) уходит в заголовок X-Figma-Token (не Bearer).

Cursor mcp.json

{
  "mcpServers": {
    "figma-mcp-server": {
      "command": "npx",
      "args": ["-y", "@mmtr-tech/figma-mcp"],
      "env": {
        "FIGMA_TOKEN": "figd_…"
      }
    }
  }
}

После добавления tools — Restart Cursor.

Tools

| Tool | Назначение | |------|------------| | ping | Локальный health-check | | get_me | Проверка токена (GET /v1/me) | | parse_figma_url | URL → file_key + node_id | | get_file | Дерево файла (depth + simplify по умолчанию) | | get_nodes | Конкретные узлы | | export_images | PNG/JPG/SVG; по умолчанию отдаёт MCP image (видение макета) | | list_comments | Комментарии + фильтры node_id / query / limit (resolved скрыты) |

Типичный workflow

1. parse_figma_url на ссылку из чата
2. get_file с depth: 2 — найти frame ids
3. export_images по нужным frames — увидеть макет
4. list_comments — обсуждение в файле

Лимиты

Тяжёлые эндпоинты (GET file, images) — Tier 1 REST: у View/Collab очень мало запросов/месяц; у Dev/Full — per-minute. При 429 клиент ретраит по Retry-After.

Skills

См. docs/SKILLS.md.