统一 Figma MCP

第一阶段调查项目，旨在构建一个统一的 Figma MCP 协调器，能够在无需修改任一现有后端的前提下，适当地使用 Plumb 和 Custom MCP。

正确的本地路径：

C:\Users\rachi\OneDrive\Documents\FIGMA UNIFIED MCP

第一阶段状态

第一阶段仅包含文档和验证。该仓库目前包含架构文档、测试结果以及一个 Custom MCP SDK 探针。尚未添加任何生产级协调器实现。

Related MCP server: Local Figma MCP Bridge

关键发现

Plumb 和 Custom 都是真实的 Figma MCP 路径，但当前的 Figma 工作流一次仅支持一个活动的 MCP 插件桥。因此，统一 MCP 应显式地暴露后端健康状态，并提供清晰的切换提示。

文档

• docs/CURRENT_SYSTEM.md

• docs/PLUMB_ARCHITECTURE.md

• docs/CUSTOM_MCP_ARCHITECTURE.md

• docs/PROTOCOL_MAP.md

• docs/CAPABILITY_MATRIX.md

• docs/ARCHITECTURE_OPTIONS.md

• docs/FAILURE_ANALYSIS.md

• docs/IMPLEMENTATION_RECOMMENDATION.md

• docs/TEST_PLAN.md

• docs/STAGE1_RESULTS.md

诊断脚本

scripts/custom-mcp-sdk-probe.mjs

示例：

node scripts\custom-mcp-sdk-probe.mjs --wait-paired --read --write

该脚本将现有的 Custom MCP 服务器作为子进程启动，使用 FIGMA-CUSTOM-MCP 中安装的 MCP SDK 通过 stdio 进行 MCP 通信，并可选择性地验证状态、读取、写入和清理操作。

第二阶段 状态

第二阶段添加了第一个真正的统一 MCP 协调器运行时：

npm run start

诊断辅助工具：

node scripts\unified-probe.mjs unified_status
node scripts\unified-probe.mjs unified_probe_backend '{"backend":"plumb"}'
node scripts\unified-probe.mjs unified_probe_backend '{"backend":"custom"}'
node scripts\unified-live-sequence.mjs

第二阶段文档：

• docs/STAGE2_ARCHITECTURE.md

• docs/STAGE2_TEST_PLAN.md

• docs/STAGE2_RESULTS.md

• docs/BACKEND_ADAPTERS.md

• docs/STATUS_MODEL.md

• docs/ERROR_MODEL.md

第三阶段 状态

第三阶段调查了自动化后端交接。结果：自动化交接被阻止，在当前的双插件架构下无法实现。统一 MCP 可以观察手动后端变更，但在没有新的插件架构或脆弱的 UI 自动化的情况下，无法合法地启动非活动的 Figma 插件。

第三阶段文档：

• docs/STAGE3_INVESTIGATION.md

• docs/HANDOFF_STATE_MACHINE.md

• docs/BACKEND_LIFECYCLE.md

• docs/STAGE3_TEST_PLAN.md

• docs/STAGE3_RESULTS.md

• docs/HANDOFF_BLOCKER.md

• docs/RUNTIME_ALTERNATIVES.md