Figma CLI工具

Ligma是一个Figma MCP的CLI替代工具,用于获取Figma节点并生成优化的代码代理工件包,帮助代理理解和实现设计。

  • by davidlee
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 davidlee/ligma

使用说明

Ligma:用于编码代理的更好的Figma MCP工具/CLI命令

Figma MCP的CLI替代品。获取Figma节点并发出 为代码代理优化的确定性、令牌高效的工件包。

它要解决的问题是:帮助代理人理解他们所做的事情 需要知道如何实现设计。Figma-json面向精确 记录文档结构,不透露意图,指导实施。

文件被下载到磁盘,而不是转储到代理的上下文窗口中 (./artifact 默认情况下,但可以指定),并且可以列出/下载 其他资产(如png或svg)。

制作 规范驱动程序.

安装

npm install -g ligma-mcp

或来源:

git clone https://github.com/davidlee/ligma && cd ligma
pnpm install && pnpm build && pnpm link --global

需要节点>=18。

MCP服务器设置(克劳德代码)

claude mcp add ligma -- ligma mcp

需要 FIGMA_TOKEN 在您的shell环境中。或者,显式传递它:

{
  "mcpServers": {
    "ligma": {
      "command": "ligma",
      "args": ["mcp"],
      "env": {
        "FIGMA_TOKEN": "your-figma-token"
      }
    }
  }
}

6个工具: figma_get_node, figma_get_outline, figma_get_render, figma_list_assets, figma_get_asset, figma_get_assets.

用法

export FIGMA_TOKEN="<your-figma-personal-access-token>"

ligma <figma-url>

或者内联传递令牌:

ligma <figma-url> --token <token>

注意:这需要一分钟的时间,下载过程中没有反馈。小旋转器很快就要来了(讽刺的是,是吗?)。

子指令

list-assets

以JSON格式列出检测到的导出目标:

ligma list-assets <figma-url>

输出一个JSON数组 { nodeId, name, format, reason } 到stdout。

标志 默认值 描述
-t, --token <token> $FIGMA_TOKEN Figma个人访问令牌
-d, --depth <n> 2 节点树深度
--max-assets <n> 20 可列出的最大资产
--no-cache 禁用获取缓存
--cache-directory <path> .cache/figma-fetch 缓存目录路径

get-asset

按节点ID获取单个资产并写入磁盘:

ligma get-asset <figma-url> <node-id>

写入资源文件并打印stdout的绝对路径。

标志 默认值 描述
-t, --token <token> $FIGMA_TOKEN Figma个人访问令牌
-o, --out <dir> ./artifacts 输出目录
-f, --format <fmt> png 图像格式(png 或 svg)
--no-cache 禁用获取缓存
--cache-directory <path> .cache/figma-fetch 缓存目录路径

选项

标志 默认值 描述
-t, --token <token> $FIGMA_TOKEN Figma个人访问令牌
-o, --out <dir> ./artifacts 输出目录
-f, --format <fmt> png 图像格式(png 或 svg)
-s, --scale <n> 2 图像比例(0.01–4.0)
-d, --depth <n> 2 节点树深度
--include-hidden false 在大纲和上下文中包含隐藏节点
--no-expand 禁用选择性扩展
--max-expand <n> 10 最大扩展目标
--expand-depth <n> 2 膨胀反射深度
--max-assets <n> 20 可出口的最大资产
--asset-format <fmt> auto 资产导出格式(auto, png, svg)
--no-cache 禁用获取缓存
--cache-directory <path> .cache/figma-fetch 缓存目录路径

项目文档

设计修改

DR 增量 描述
DR-001 DE-001 PROD-001交付计划
DR-002 DE-002 项目脚手架和Figma客户
DR-003 DE-003 核心规范化引擎
DR-004 DE-004 语义推理、令牌和资产
DR-005 DE-005 大纲和上下文生成
DR-006 DE-006 选择性扩展和缓存
DR-007 DE-007 采用严格的lint配置
DR-008 DE-008 待办事项修复:单个笔划权重和交互提取
DR-009 DE-009 资产出口管道
DR-010 DE-010 最小MCP传输层