使用说明
Figma MCP服务器
基于模型上下文协议(MCP)的Figma API服务器实现,支持Figma插件和小部件集成。
特性
- 通过MCP与Figma API互动
- 用于Figma插件通信的WebSocket服务器
- 支持Figma控件开发
- 通过命令行参数配置环境变量
- 丰富的Figma操作工具
安装
- 克隆存储库:
git clone <repository-url>
cd figma-mcp
- 安装依赖项:
bun install
配置
环境变量
创建一个 .env 文件并设置以下环境变量:
FIGMA_PERSONAL_ACCESS_TOKEN=your_figma_token
PORT=3001
NODE_ENV=development
获取Figma访问令牌
- 登录到 Figma
- 转到帐户设置>个人访问令牌
- 创建新的访问令牌
- 将令牌复制到您的
.env文件或通过命令行参数传递
用法
构建项目
bun run build
运行开发服务器
bun run dev
使用命令行参数
支持通过设置环境变量 -e 参数:
bun --watch src/index.ts -e FIGMA_PERSONAL_ACCESS_TOKEN=your_token -e PORT=6000
您还可以使用专用的令牌参数:
bun --watch src/index.ts --token your_token
或其简写:
bun --watch src/index.ts -t your_token
在游标中配置MCP
添加到 .cursor/mcp.json 文件:
{
"Figma MCP": {
"command": "bun",
"args": [
"--watch",
"/path/to/figma-mcp/src/index.ts",
"-e",
"FIGMA_PERSONAL_ACCESS_TOKEN=your_token_here",
"-e",
"PORT=6000"
]
}
}
可用工具
服务器提供以下Figma操作工具:
- 文件操作:获取文件、版本等。
- 节点操作:获取和操纵Figma节点
- 注释操作:管理Figma文件中的注释
- 图像操作:将Figma元素导出为图像
- 搜索功能:搜索Figma文件中的内容
- 组件操作:管理Figma组件
- 画布操作:创建矩形、圆形、文本等。
- 小部件操作:管理Figma小部件
Figma插件开发
插件介绍
Figma插件是扩展Figma功能的定制工具,可实现工作流自动化、添加新功能或与外部服务集成。此MCP服务器提供了一种开发、测试和部署Figma插件的便捷方式。
建造和测试
构建插件:
bun run build:plugin
在开发模式下运行:
bun run dev:plugin
在Figma中加载插件
- 在Figma中右键单击打开菜单->插件->开发->从清单导入插件。..
- 选择插件
manifest.json文件 - 您的插件现在将出现在Figma的插件菜单中
插件与MCP服务器的交互
插件可以通过WebSocket与MCP服务器通信,以实现:
- 复杂的数据处理
- 外部API集成
- 跨会话数据持久化
- AI功能集成
发展
构建小部件
bun run build:widget
构建插件
bun run build:plugin
开发模式
bun run dev:widget # Widget development mode
bun run dev:plugin # Plugin development mode
许可证
麻省理工学院
