使用说明
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传输层 |
