MCP Server 将 Figma 设计转换为类似伪代码的结构,简单且高效,便于大语言模型理解设计背景。
"Figma MCP Server": {
"command": "npx",
"args": ["-y", "figma-codegen-mcp", "--figma_api_key=<YOUR-FIGMA-PERSONAL-ACCESS-TOKEN>"]
}
git clone <repository-url>
cd figma-mcp-server
npm install
npm run build
用于热重载的开发:
# 安装依赖
npm install
# 设置环境变量
cp .env.example .env
# 编辑 .env 文件并添加你的 FIGMA_API_TOKEN
# 启动带有热重载的开发服务器
npm run dev
# 或者构建生产版本
npm run build
# 启动生产服务器
npm start
此 Figma MCP Server 提供了两种主要工具来与 Figma 设计进行交互:
fetch_figma_node_image获取 Figma 节点或框架的 PNG 图像,并以 base64 数据形式返回。
描述: 下载任何 Figma 设计元素(框架、组件、层等)的 PNG 图像作为其视觉表示。
参数:
fileKey (字符串,必需):Figma 文件的键。可以在 Figma URL 如 figma.com/(file|design)/<fileKey>/... 中找到。nodeId (字符串,必需):要捕获的具体节点的ID。在 URL 参数如 node-id=<nodeId> 中找到。返回值: 基于64编码的PNG图像和MIME类型。
示例用例:
generate_pseudo_code_from_figma_frame为 Figma 设计生成 JSX 和 CSS 伪代码。
描述: 分析 Figma 设计元素并生成相应的伪 HTML + CSS 代码。生成的代码包括基于您的 Figma 组件库的语义 HTML 结构、CSS 属性和伪 React JSX 组件。
参数:
fileKey (字符串,必需):Figma 文件的键。可以在 Figma URL 如 figma.com/(file|design)/<fileKey>/... 中找到。nodeId (字符串,必需):要转换的框架/组件的ID。在 URL 参数如 node-id=<nodeId> 中找到。返回值: 包含以下内容的格式化文本:
示例用例:
当分享 Figma 设计时,URL 包含所需的参数:
https://www.figma.com/design/ABC123XYZ/My-Design?node-id=1200%3A23&t=randomstring
↑ ↑
fileKey nodeId (URL 编码)
ABC123XYZ(/design/ 或 /file/ 之后的部分)1200(从 node-id 参数中解码)这些工具旨在与兼容 MCP 的客户端一起使用。只需提供一个 Figma 设计 URL,客户端即可自动提取文件键和节点ID,并调用适当的工具来获取图像和/或生成代码。