Cursor Talk To Figma MCP
Интеграция между Cursor AI и Figma через протокол MCP (Model Context Protocol). Позволяет Cursor читать дизайны Figma и программно их изменять.
Структура проекта
src/talk_to_figma_mcp/ — TypeScript MCP-сервер для интеграции с Figma
src/cursor_mcp_plugin/ — плагин Figma для связи с Cursor
src/socket.ts — WebSocket-сервер, обеспечивающий обмен между MCP-сервером и плагином Figma
Быстрый старт
-
Установи Bun, если ещё не установлен:
curl -fsSL https://bun.sh/install | bash
-
Запусти настройку (также установит MCP в активный проект Cursor):
bun setup
-
Запусти WebSocket-сервер:
bun socket
-
Запусти MCP-сервер:
bunx cursor-talk-to-figma-mcp
-
Установи плагин Figma (см. ниже).
Ручная установка
MCP-сервер: интеграция с Cursor
Добавь сервер в конфигурацию MCP Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"TalkToFigma": {
"command": "bunx",
"args": ["cursor-talk-to-figma-mcp"]
}
}
}
WebSocket-сервер
Запусти:
bun socket
Плагин Figma
- В Figma: Plugins > Development > New Plugin
- Выбери «Link existing plugin»
- Укажи файл
src/cursor_mcp_plugin/manifest.json
- Плагин появится в разделе Development-плагинов
Windows + WSL
-
Установи Bun через PowerShell:
powershell -c "irm bun.sh/install.ps1|iex"
-
Раскомментируй hostname: "0.0.0.0" в src/socket.ts:
// uncomment this to allow connections in windows wsl
hostname: "0.0.0.0",
-
Запусти WebSocket:
bun socket
Использование
- Запусти WebSocket-сервер
- Установи MCP-сервер в Cursor
- Открой Figma и запусти плагин Cursor MCP Plugin
- Подключи плагин к WebSocket-серверу через
join_channel
- Используй Cursor для взаимодействия с Figma через MCP-инструменты
MCP-инструменты
Документ и выделение
get_document_info — информация о текущем документе Figma
get_selection — информация о текущем выделении
get_node_info — детальная информация об узле
get_nodes_info — информация о нескольких узлах по массиву ID
Создание элементов
create_rectangle — создать прямоугольник
create_frame — создать фрейм
create_text — создать текстовый узел
Изменение текста
set_text_content — задать содержимое текстового узла
Стилизация
set_fill_color — задать цвет заливки (RGBA)
set_stroke_color — задать цвет и толщину обводки
set_corner_radius — задать скругление углов
Компоновка и организация
move_node — переместить узел
resize_node — изменить размер узла
delete_node — удалить узел
clone_node — клонировать узел
Компоненты и стили
get_styles — информация о локальных стилях
get_local_components — информация о локальных компонентах
get_team_components — информация о командных компонентах
create_component_instance — создать экземпляр компонента
Экспорт и продвинутое
export_node_as_image — экспорт узла как изображение (PNG, JPG, SVG, PDF)
execute_figma_code — выполнить произвольный JavaScript-код в Figma (осторожно!)
Управление подключением
join_channel — присоединиться к каналу для связи с Figma
Рекомендации
- Всегда присоединяйся к каналу перед отправкой команд
- Сначала получай обзор документа через
get_document_info
- Перед изменениями проверяй текущее выделение через
get_selection
- Используй соответствующие инструменты создания:
create_frame для контейнеров, create_rectangle для фигур, create_text для текста
- Проверяй изменения через
get_node_info
- По возможности используй экземпляры компонентов для единообразия
- Все команды могут выбрасывать исключения — обрабатывай ошибки
Разработка
Сборка плагина Figma
cd src/cursor_mcp_plugin
Редактируй code.js и ui.html.
Лицензия
MIT
Комментарии
Комментариев пока нет. Будьте первым.