安装配置

本页将指导你如何安装和配置 feuse-mcp。

获取 Figma API Key

访问 Figma Developer Settings 取您的 Figma API 密钥
点击 "Create new personal access token"
为你的令牌命名（例如："feuse-mcp"）
复制生成的 API key

MCP 客户端配置

在你的 MCP 客户端配置文件中添加 feuse-mcp 服务器：

json

{
  "mcpServers": {
    "feuse-mcp": {
      "command": "npx",
      "args": ["feuse-mcp@latest"],
      "env": {
        "FIGMA_API_KEY": "your_figma_api_key_here"
      }
    }
  }
}

开发者配置（从源码）

json

{
  "mcpServers": {
    "feuse-mcp": {
      "command": "node",
      "args": ["/path/to/feuse-mcp/dist/main.cjs"],
      "env": {
        "FIGMA_API_KEY": "your_figma_api_key_here"
      }
    }
  }
}

权限设置

确保 feuse-mcp 有权限访问你的项目目录：

读取项目文件（用于项目分析）
写入生成的文件
创建临时文件（用于截图和对比）

验证安装

安装和配置完成后，在 MCP 客户端中验证 feuse-mcp 是否正常工作：

1. 检查服务器状态

在 VSCode Copilot 或其他 MCP 客户端中，验证 feuse-mcp 服务器是否正常连接

你应该看到以下 8 个工具：

Figma-To-Code
extract-svg-assets
extract-color-vars
similarity-figma
api-automation
initialize-project-standard
Download-Figma-Images
download-svg-assets

2. 测试基本功能

尝试使用一个简单的工具来验证配置：

请使用 initialize-project-standard 工具

如果配置正确，工具会分析你的项目结构并生成相应的标准化文件。

故障排除

常见问题

问题：Figma API Key 无效

解决方案：检查 API Key 是否正确复制，确保没有额外的空格或字符

问题：MCP 服务器无法启动

解决方案：请确认是否在对应的MCP客户端内正确配置了MCP服务，并确保网络连接正常

问题：权限被拒绝

解决方案：检查文件系统权限，确保 MCP 服务器可以读写项目目录

问题：工具执行失败

解决方案：查看 MCP 客户端的日志输出，通常会显示详细的错误信息
如果还有其他问题，请查阅 API 文档或提交 GitHub Issues。

安装配置 ​

获取 Figma API Key ​

MCP 客户端配置 ​

开发者配置（从源码） ​

权限设置 ​

验证安装 ​

1. 检查服务器状态 ​

2. 测试基本功能 ​

故障排除 ​

常见问题 ​