实现 Cursor AI 与 Figma 之间的 Model Context Protocol (MCP) 集成,使 Cursor 能够通过程序读取和修改 Figma 设计文件。
一分钟了解#
Cursor Talk to Figma MCP 是一个连接 Cursor AI 编辑器与 Figma 设计工具的桥梁,允许 Cursor 的智能代理与 Figma 进行双向通信。设计师和开发者可以通过编程方式批量修改 Figma 设计,将手动操作转化为自动化流程,大幅提升设计迭代效率。
核心价值:实现设计文件的程序化操作,将重复性设计任务自动化,提升设计修改效率。
快速上手#
安装难度:中 - 需要配置 MCP 服务器、WebSocket 服务器并安装 Figma 插件
# 安装 Bun(如果尚未安装)
curl -fsSL https://bun.sh/install | bash
# 运行设置(这将同时安装 MCP 到您的 Cursor 项目)
# 启动 WebSocket 服务器
适合我的场景吗?
- ✅ 设计系统维护:批量更新设计组件实例的覆盖属性
- ✅ 内容本地化:大规模替换设计中的文本内容
- ✅ 设计自动化:将手动注释转换为 Figma 原生注释
- ❌ 简单的单次设计修改:对于少量修改,手动操作更快
- ❌ 无编程基础:需要基本的 TypeScript 和命令行操作知识
核心能力#
1. 文档与选择操作 - 全面掌控设计文件结构#
- 提供获取文档信息、选择状态、节点详情等功能 实际价值:让 AI 能够理解设计文件的结构和组织方式,为后续操作奠定基础
2. 批量文本处理 - 大规模内容更新#
- 智能扫描文本节点,支持单节点和多节点文本内容批量修改 实际价值:实现设计稿中所有文本内容的快速替换,支持多语言设计和内容更新
3. 组件实例管理 - 高效处理设计组件#
- 获取和设置组件实例的覆盖属性,支持在多个目标实例间传播修改 实际价值:简化设计系统维护,确保组件变体的一致性,减少重复性设计工作
4. 自动布局控制 - 精确控制设计布局#
- 设置布局模式、填充、对齐方式和间距等属性 实际价值:自动化调整设计布局,响应式适配不同屏幕尺寸和设计规范
5. 样式与视觉效果 - 统一设计语言#
- 设置填充色、描边色、圆角等视觉属性 实际价值:确保设计系统的一致性,快速应用品牌色彩和样式规范
技术栈与集成#
开发语言:TypeScript 主要依赖:Bun 运行时、WebSocket 服务器、Model Context Protocol (MCP) 集成方式:MCP 服务器 / Figma 插件 / WebSocket 通信
维护状态#
- 开发活跃度:活跃维护,有最近的提交和发布
- 最近更新:最近有新功能添加(批量文本替换、实例覆盖传播等)
- 社区响应:有贡献者参与项目功能开发
文档与学习资源#
- 文档质量:全面,包含详细的 MCP 工具说明和最佳实践指南
- 官方文档:https://github.com/grab/cursor-talk-to-figma-mcp
- 示例代码:提供多种使用场景的示例和视频教程