Unified Figma MCP

Проект исследования этапа 1 для координатора Unified Figma MCP, который может надлежащим образом использовать Plumb и Custom MCP, не изменяя ни один из существующих бэкендов.

Правильный локальный путь:

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

Статус этапа 1

Этап 1 — это только документация и проверка. Репозиторий в настоящее время содержит архитектурную документацию, результаты тестов и пробный скрипт Custom MCP SDK. Реализация производственного координатора ещё не добавлена.

Related MCP server: Local Figma MCP Bridge

Ключевой вывод

Plumb и Custom оба работают как реальные пути Figma MCP, но текущий рабочий процесс Figma поддерживает только один активный мост плагина MCP за раз. Поэтому Unified 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 как дочерний процесс, общается по MCP через stdio, используя MCP SDK, установленный в FIGMA-CUSTOM-MCP, и при необходимости проверяет статус, чтение, запись и очистку.

Статус этапа 2

Этап 2 добавляет первую реальную среду выполнения координатора Unified 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

Документация этапа 2:

• 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

Статус этапа 3

Этап 3 исследовал автоматическую передачу управления бэкендом. Результат: АВТОМАТИЧЕСКАЯ ПЕРЕДАЧА УПРАВЛЕНИЯ ЗАБЛОКИРОВАНА в рамках текущей архитектуры с двумя плагинами. Unified MCP может наблюдать за ручными изменениями бэкенда, но не может легитимно запустить неактивный плагин Figma без новой архитектуры плагинов или хрупкой автоматизации пользовательского интерфейса.

Документация этапа 3:

• 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