Figma MCP 服务器

这是一个模型上下文协议（MCP）服务器，通过标准化接口提供对Figma文件和设计资源的访问。

功能

• 文件访问：获取具有深度控制的Figma文件结构
• 节点导航：访问文件中的特定组件
• 图像导出：以PNG、JPG、SVG或PDF格式导出设计资源
• URL解析：从Figma URL中提取文件键
• 深度管理：控制响应大小以防止超出令牌限制
• 资源支持：导出的图像是作为MCP资源可用的，并且内容是base64编码的

安装

方案1：从crates.io安装（推荐）

cargo install figma-mcp

方案2：从源码构建

git clone https://github.com/paulvandermeijs/figma-mcp.git
cd figma-mcp
cargo build --release

快速开始

1. 从开发者设置获取您的Figma令牌

2. 设置环境变量：

   export FIGMA_TOKEN="your_token_here"
   

3. 运行服务器：

   # 如果通过cargo install安装
   figma-mcp
   
   # 如果从源码构建
   cargo run --release
   

使用方法

工作流程

1. 使用parse_figma_url从任何Figma URL中提取文件键
2. 使用文件键与其他工具访问文件数据
3. 使用深度参数来控制响应大小

可用工具

• parse_figma_url - 从Figma URL中提取文件键
• get_file - 获取文件结构（带深度控制）
• get_file_nodes - 获取特定节点（带深度控制）
• export_images - 从节点导出图像
• get_me - 测试认证
• help - 使用说明

资源

导出的图像是自动作为MCP资源可用的：

• 列出资源以查看所有导出的图像
• 读取资源以获取base64编码的图像数据
• 资源URI：figma://file/{file_key}/node/{node_id}.{format}

深度参数

• depth=1（默认）：仅页面（文件）或直接子项（节点）
• depth=2：页面+顶级对象或子项+孙项
• depth=3+：更深层次的遍历（谨慎使用）

支持的URL

• https://www.figma.com/file/FILE_ID/filename
• https://www.figma.com/design/FILE_ID/filename
• 带有节点ID的URL：?node-id=1%3A2

开发

cargo test          # 运行测试
RUST_LOG=info cargo run  # 启用日志运行

许可证

MIT许可证 - 详情见LICENSE文件。 </中文翻译>