cursor-talk-to-figma-mcp

环境要求

• 已安装 Bun 运行环境（README 用 Bun 执行 setup 与 socket）
• 本地已获取项目代码，并知道仓库所在路径（用于配置 MCP 的 server.ts 路径）
• 已安装 Cursor 或 Claude Code 等支持 MCP 的 AI 编码客户端
• 拥有 Figma 账号，可安装并运行 Cursor MCP Plugin
• 可用浏览器打开 Figma 社区插件页面

安装与启动步骤

1. 1安装 Bun

   在终端执行官方安装脚本，安装完成后可能需要重开终端使 bun 命令生效。

   curl -fsSL https://bun.sh/install | bash

   复制

2. 2运行项目初始化

   在项目目录下执行 bun setup，它同时会把 MCP 安装到你当前活跃的 Cursor 项目中。

   bun setup

   复制

3. 3启动 WebSocket 服务

   该服务负责在 MCP 服务器与 Figma 插件之间转发消息，需保持运行不要关闭终端。

   bun socket

   复制

4. 4安装 Figma 插件

   从 Figma 社区页面安装 Cursor Talk To Figma MCP 插件，或参考 README 的 Figma plugin 章节本地安装。

5. 5配置本地开发 MCP

   如需本地开发，把 MCP 配置指向本仓库的 server.ts 绝对路径，替换 /path-to-repo。

   {
     "mcpServers": {
       "TalkToFigma": {
         "command": "bun",
         "args": ["/path-to-repo/src/talk_to_figma_mcp/server.ts"]
       }
     }
   }

   复制

6. 6连接 Figma 与 AI

   在 Figma 中运行 Cursor MCP Plugin，用 join_channel 加入频道连上 WebSocket，再用 Cursor 调用 MCP 工具。

关键配置

如何确认成功

bun socket 终端保持运行无报错，且 Figma 插件通过 join_channel 成功加入频道，即可在 Cursor 中调用 MCP 工具与 Figma 通信。

常见问题

注意事项

• bun socket 启动的 WebSocket 服务需要全程保持运行，否则 Figma 插件无法与 AI 通信。
• bun setup 会把 MCP 安装到 Cursor 当前活跃项目中，请确认 Cursor 打开的是目标项目。
• README 中的 Manual Setup and Installation 章节未给出具体内容，本地开发请以 Local Development Setup 的 mcp 配置为准。