Figma MCP Server

用于分析Figma文件结构的MCP（模型上下文协议）服务器。

功能

• 分析Figma文件以提取节点层次结构
• 支持REST API和MCP协议
• 可配置的节点树深度

预备条件

• Node.js 16+
• npm 或 yarn
• 一个Figma API密钥

安装

从npm安装

npm install -g figma-mcp-server

从源码安装

git clone https://github.com/yourusername/mcp-figma.git
cd mcp-figma
npm install
npm run build

配置

复制示例环境文件并添加您的Figma API密钥：

cp .env.example .env

然后编辑.env文件并添加您的Figma API密钥：

FIGMA_API_KEY=your_figma_api_key_here

您可以在Figma账户设置中获取Figma API密钥：https://www.figma.com/developers/api#access-tokens

使用方法

作为REST API服务器

启动服务器：

npm start

这将在端口3000（或.env文件中指定的端口）上启动一个Express服务器。

API端点

• GET /health - 健康检查端点
• GET /openapi.json - OpenAPI规范
• GET /mcp.json - MCP清单
• POST /analyze - 分析Figma文件

分析端点的示例请求：

curl -X POST http://localhost:3000/analyze \
  -H "Content-Type: application/json" \
  -d '{"figmaUrl": "https://www.figma.com/file/FILE_ID/PROJECT_NAME?node-id=NODE_ID", "depth": 2}'

作为MCP服务器

该服务器可以通过MCP协议直接由LLM使用：

figma-mcp-server --cli

或者如果从源码运行：

npm run start -- --cli

客户端示例

包含了一个简单的客户端示例。要使用它：

node client-example.js https://www.figma.com/file/FILE_ID/PROJECT_NAME?node-id=NODE_ID 2

最后一个参数是可选的深度参数。

开发

在开发模式下运行

npm run dev

测试

npm test

Docker

提供了一个Dockerfile用于容器化部署：

docker build -t figma-mcp-server .
docker run -p 3000:3000 --env-file .env figma-mcp-server

许可证

MIT </中文翻译>