Figma MCP 服务器

Figma MCP 服务器

一个高效生成 Figma 节点树及其相关元数据的 MCP 服务器。

快速入门

  1. 安装
    • 使用 npm 全局安装:npm install -g figma-mcp-server
    • 或从源码安装:
      git clone https://github.com/moonray/mcp-figma.git
      cd mcp-figma
      npm install
      npm run build
      
  2. 配置
    • 复制 .env.example 文件为 .env,并填写您的 Figma API 密钥:
      cp .env.example .env
      
    • 编辑 .env 文件,添加 FIGMA_API_KEY=your_figma_api_key_here
  3. 运行
    • 启动 REST API 服务:npm start
    • 或作为 CLI 工具运行:npm run start -- --cli
  4. 测试分析接口
    • 示例命令:
      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}'
      
  5. 开发模式
    • 开发时使用:npm run dev
  6. Docker 部署
    • 构建镜像:docker build -t figma-mcp-server .
    • 运行容器:docker run -p 3000:3000 --env-file .env figma-mcp-server