MCP 实战：利用 Figma AI Bridge 生成前端代码

实现步骤

创建项目结构

首先建立基础的目录结构，方便后续代码管理：

mkdir -p src/components
mkdir -p src/styles
mkdir -p src/assets

初始化 MCP Server

创建 start-mcp.js 文件来启动服务。这里需要注意异常处理，确保服务启动失败时能给出明确提示：

// start-mcp.js
const { startServer } = require('@figma-ai-bridge/mcp-server');
const config = require('./figma-mcp-config.json');

async function start() {
  try {
    const server = await startServer(config);
    console.log('MCP Server 已启动在端口:', server.port);
    console.log('访问 http://localhost:', server.port, '查看生成的代码');
  } catch (error) {
    console.error('启动 MCP Server 失败:', error);
  }
}

start();

连接 Figma 设计稿

在 IDE 中打开项目后，通过 MCP Server 面板进行操作：

1. 点击左侧的 MCP Server 图标
2. 选择 'Figma AI Bridge'
3. 输入你的 Figma 访问令牌
4. 选择要转换的设计稿文件和页面

配置代码生成选项

在 MCP Server 面板中，可以根据项目需求调整生成策略：

• 框架选择：React、Vue、HTML、Svelte 等
• 样式方案：Tailwind CSS、普通 CSS、Styled Components 等
• 响应式设置：启用或禁用响应式布局
• 组件命名规则：PascalCase、camelCase 等
• 代码风格：缩进、分号等偏好设置

生成前端代码

1. 点击 'Generate Code' 按钮
2. MCP Server 会分析 Figma 设计稿
3. 自动生成对应的前端代码
4. 代码会保存到配置的输出目录中

集成到项目中

生成代码后，将其集成到你的前端项目中。以 React 为例：

// App.jsx
import React from 'react';
import Header from './components/Header';
import Hero from './components/Hero';
import Features from './components/Features';
import Footer from './components/Footer';
import './App.css';

function App() {
  return (
    <div className="App">
      <Header />
      <Hero />
      <Features />
      <Footer />
    </div>
  );
}

export default App;

功能特性

核心功能

• 智能设计分析：自动识别设计稿中的组件、布局和样式
• 多框架支持：支持 React、Vue、HTML、Svelte 等多种前端框架
• 样式方案选择：提供 Tailwind CSS、普通 CSS、Styled Components 等多种样式方案
• 响应式设计：自动生成适配不同屏幕尺寸的响应式代码
• 组件化结构：智能拆分设计为可复用的组件
• 代码质量保证：生成符合最佳实践的整洁代码

技术特点

• 实时同步：支持设计稿变更后的实时代码更新
• 类型生成：自动生成 TypeScript 类型定义
• 性能优化：生成的代码注重性能和加载速度
• 可扩展性：支持自定义生成规则和模板
• 多语言支持：支持生成不同语言的代码注释

使用示例

基本用法

# 启动 MCP Server
node start-mcp.js
# 或者使用 npx
npx @figma-ai-bridge/mcp-server --config figma-mcp-config.json

命令行选项

# 查看帮助信息
npx @figma-ai-bridge/mcp-server --help
# 指定配置文件
npx @figma-ai-bridge/mcp-server --config custom-config.json
# 指定输出目录
npx @figma-ai-bridge/mcp-server --output ./custom-output
# 选择特定页面
npx @figma-ai-bridge/mcp-server --page-id "页面 ID"

高级配置

对于更复杂的需求，可以扩展配置文件：

{
  "figma": {
    "accessToken": "你的 Figma 访问令牌",
    "fileId": "设计稿文件 ID",
    "pageId": "页面 ID",
    "branchId": "分支 ID（可选）",
    "versionId": "版本 ID（可选）"
  },
  "output": {
    "format": "react",
    "framework": "nextjs",
    "outputDir": "./src/components",
    "componentPrefix": "Figma",
    "useIndexFiles": true
  },
  "options": {
    "generateTypes": true,
    "useTailwind": true,
    "responsive": true,
    "removeComments": false,
    "optimizeImages": true,
    "imageOutputDir": "./public/images"
  },
  "customTemplates": {
    "component": "./templates/component.hbs",
    "style": "./templates/style.hbs"
  }
}

注意事项

1. Figma 访问权限：确保你的访问令牌具有读取设计稿的权限
2. 设计稿结构：保持设计稿结构清晰，组件命名规范，有助于生成更好的代码
3. 样式一致性：设计稿中使用一致的颜色、字体和间距系统，生成的代码会更整洁
4. 响应式设计：在设计稿中考虑不同屏幕尺寸的布局，生成的响应式代码会更准确
5. 组件拆分：合理拆分设计为组件，避免生成过大的单一文件
6. 性能考虑：对于复杂的设计稿，可能需要调整生成选项以优化性能
7. 代码审查：生成代码后，建议进行代码审查，根据实际需求进行必要的调整

相关资源

• Figma 官方文档：https://www.figma.com/resources/learn-design/
• MCP Server 文档：https://mcp-server-docs.example.com
• 前端框架文档：
  • React: https://reactjs.org/docs/
  • Vue: https://vuejs.org/guide/
  • Svelte: https://svelte.dev/docs/
• 样式方案文档：
  • Tailwind CSS: https://tailwindcss.com/docs/
  • Styled Components: https://styled-components.com/docs