TalkToFigma Desktop MCP 服务器
使用说明
- 项目简介 TalkToFigma Desktop 将 Figma 的设计协作与 MCP（Model Context Protocol）后端服务器结合起来，提供对资源、工具和提示模板的托管、管理和执行能力，并通过 JSON-RPC 与 LLM 客户端进行交互。它实现了多种传输方式（stdio、WebSocket、SSE），用于在桌面环境中为 AI 助手提供稳定、可扩展的上下文服务。
- 主要功能点
- MCP 协议支持：实现标准化的初始化、工具列出、工具调用、资源与提示列表等 MCP 请求/响应的处理逻辑。
- 服务器与传输协议：提供基于 WebSocket 的实时通信、基于 STDIO 的独立服务器进程以及 SSE 传输（历史实现，向后兼容）。
- MCP 工具与提示：内置大量工具集成（如与 Figma 插件交互、创建/读取节点、文本操作等），以及 Prompts 的渲染与管理。
- 会话与状态管理：负责会话管理、连接状态、错误处理，以及对外暴露的服务器状态信息。
- 本地化桌面集成：通过 Electron 桌面应用提供系统托盘、日志流、插件对接、以及 MCP 配置导出/导入支持。
- 安装步骤
- 获取并安装 TalkToFigma Desktop（官方发行版或自行打包的 Electron 应用）。
- 启动应用并在托盘中“Start Server”以启动 WebSocket 服务（端口为 3055）。
- 配置 MCP 客户端（Cursor、Claude Code 等）以指向工作目录中的 MCP 服务器：
- 对于 stdio 基于客户端的连接，通常需要配置一个服务器命令指向 mcp-server.cjs（桌面应用会提供默认路径）。
- 桌面应用会在设置页提供 MCP 配置信息，包含 serverName、command、args 等字段。
- 如需使用 Figma 插件相关功能，请在 Figma 中安装并运行对应插件以连接到桌面应用的 WebSocket 端口（3055）。
- 服务器配置（供 MCP 客户端读取并配置，非运行时代码）
该配置是给 MCP 客户端使用的，描述桌面应用中 MCP 服务器的启动方式与参数。示例配置如下（以 TalkToFigmaDesktop 为例，实际路径请根据打包后的位置替换成实际路径）：
{
"mcpServers": {
"TalkToFigmaDesktop": {
"command": "path/to/mcp-server.cjs",
"args": []
}
}
}
说明：
- "TalkToFigmaDesktop" 为 MCP 服务器名称，与桌面应用中的服务器标识保持一致。
- "command" 指向桌面应用提供的 stdio 服务器可执行文件路径（通常是 mcp-server.cjs），桌面应用会在不同平台提供对应的默认路径或注释以帮助定位。
- "args" 通常为空数组，若需要传递自定义参数，请按实际服务器参数配置。
- 基本使用方法
- 启动服务器：在 TalkToFigma Desktop 的系统托盘中选择“Start Server”。
- 连接并使用工具：在你的 MCP 客户端中配置 TalkToFigmaDesktop 服务器后，发送 MCP 请求（初始化、列出工具、调用工具等）以控制 Figma 插件或读取资源。
- 监控与日志：通过桌面应用的 Terminal 日志页面查看运行日志，排查连接、超时、权限等问题。
- 更新与维护：如需升级或变更工具/ Prompts，请使用应用内的工具管理和日志查看功能，确保 MCP 客户端与服务器端工具集合保持同步。