解决cursor-talk-to-figma-mcp项目中的manifest.json导入问题

在使用cursor-talk-to-figma-mcp项目时，开发者可能会遇到manifest.json导入错误的问题。本文将详细分析问题原因并提供完整的解决方案。

问题现象分析

当尝试在Figma开发模式下导入manifest.json文件时，系统会报错提示"Manifest error: The manifest editorType does not include 'dev'"。这是因为manifest.json文件中缺少对开发模式的支持声明。

根本原因

cursor-talk-to-figma-mcp插件在设计时并未考虑开发模式的支持，因为开发模式下无法执行写入操作。这是Figma平台的一个限制，开发模式下许多核心功能会受到限制。

解决方案

1. 关闭开发模式：这是最简单直接的解决方案。在Figma设置中关闭开发模式后，插件就能正常加载和运行。

2. 修改manifest.json（不推荐）： 虽然可以手动在manifest.json的editorType字段中添加"dev"值，但这会导致插件功能受限，无法正常执行MCP相关操作。

连接问题的额外解决方案

在解决manifest.json问题后，部分用户可能会遇到与Cursor的连接问题。以下是完整的连接配置指南：

1. 项目结构确认： 确保项目目录结构正确，包含必要的文件：

   • src/cursor_mcp_plugin/ 存放插件核心文件
   • src/socket.ts WebSocket服务器
   • src/talk_to_figma_mcp/ 主服务目录

2. Bun环境配置：

   • 确保已安装Bun运行时
   • 在mcp.json中使用Bun的完整路径而非相对路径
   • 示例配置：

     "TalkToFigma": {
       "command": "/path/to/.bun/bin/bun",
       "args": ["/project/path/src/talk_to_figma_mcp/server.ts"]
     }
     

3. 连接流程验证：

   • 启动WebSocket服务器（运行socket.ts）
   • 连接Figma插件到WebSocket服务器
   • 连接MCP服务器到Cursor
   • 在Cursor中使用join_channel加入与Figma插件相同的频道

常见错误排查

1. ENOENT错误： 通常是由于系统找不到Bun执行文件导致，解决方案是使用Bun的绝对路径。

2. 连接失败：

   • 检查端口是否被占用
   • 验证频道名称是否一致
   • 确保所有服务都已正确启动

3. 权限问题： 在某些系统上可能需要为脚本文件添加执行权限。

最佳实践建议

1. 保持开发环境干净，避免路径中包含空格或特殊字符
2. 使用版本管理工具跟踪manifest.json的变更
3. 在非开发模式下测试插件功能
4. 定期检查Figma API和Cursor API的更新，确保兼容性

通过以上步骤，开发者应该能够顺利解决cursor-talk-to-figma-mcp项目中的manifest导入和连接问题，实现Figma与Cursor之间的顺畅通信。