Figma MCP Server

Figma MCP Server (Python)

Figma Model Context Protocol (MCP) server, реализованный на Python с использованием FastMCP. Этот сервер позволяет AI ассистентам взаимодействовать с Figma через WebSocket соединение для чтения данных и анализа дизайнов.

🎯 Возможности

📖 Чтение данных: Получение информации о документах, узлах, компонентах и стилях
🔍 Поиск и анализ: Сканирование узлов по типам, поиск текстового контента
📤 Экспорт: Экспорт узлов как изображений в различных форматах
📋 Аннотации: Просмотр аннотаций в документах
🧩 Компоненты: Работа с компонентами и их экземплярами
🔗 Прототипирование: Получение информации о реакциях и связях

🚫 Ограничения

Для безопасности этот сервер НЕ поддерживает:

Создание новых элементов
Изменение стилей, цветов или текста (инструменты set_*)
Операции изменения узлов (перемещение, изменение размера, удаление, клонирование)

📋 Доступные инструменты (14 шт.)

🔗 Подключение

join_channel - Присоеди��иться к каналу для связи с Figma

📖 Получение информации

get_document_info - Получить информацию о текущем документе Figma
get_selection - Получить информацию о текущем выделении
read_my_design - Получить детальную информацию о выделении включая все детали узлов
get_node_info - Получить информацию о конкретном узле по ID
get_nodes_info - Получить информацию о нескольких узлах
get_styles - Получить все стили из документа
get_local_components - Получить все локальные компоненты

🧩 Компоненты

get_instance_overrides - Получить переопределения экземпляра компонента

🔍 Поиск и сканирование

scan_text_nodes - Сканировать текстовые узлы внутри заданного узла
scan_nodes_by_types - Сканировать узлы определенных типов (TEXT, RECTANGLE, FRAME)

📤 Экспорт

export_node_as_image - Экспортировать узел как изображение (PNG, JPG, SVG, PDF)

📋 Аннотации

get_annotations - Получить аннотации для узла или всего документа

🔗 Прототипирование

get_reactions - Получить реакции (интерактивные связи) для узлов

🏗️ Архитектура

AI Client (Cursor) ←→ MCP Server ←→ WebSocket Server ←→ Figma Plugin

MCP Server - Предоставляет инструменты для AI
WebSocket Server - Координирует соединения и каналы
Figma Plugin - Выполняет команды в Figma

🚀 Быстрый старт

1. Установка зависимостей

cd python-version
python -m venv venv
source venv/bin/activate  # Linux/Mac
# или venv\Scripts\activate  # Windows
pip install -r requirements.txt

2. Запуск WebSocket сервера

python websocket_proxy.py --port 3055 --debug

3. Запуск в Figma

Откройте Figma Desktop
Перейдите в Plugins → Development → Import plugin from manifest...
Выберите src/cursor_mcp_plugin/manifest.json
Запустите плагин "Cursor MCP Plugin"
Подключитесь к серверу на порту 3055
Запомните Channel ID (например: abc123xyz)

4. Запуск MCP сервера

python -m src.figma_mcp.server --server localhost:3055

5. Подключение к каналу

Используйте инструмент join_channel с полученным Channel ID:

{
  "tool": "join_channel",
  "arguments": {
    "channel": "abc123xyz"
  }
}

🛠️ Примеры использования

Получение информации о документе

{
  "tool": "get_document_info",
  "arguments": {}
}

Получение информации о узле

{
  "tool": "get_node_info", 
  "arguments": {
    "node_id": "4472:98013"
  }
}

Поиск текстовых узлов

{
  "tool": "scan_text_nodes",
  "arguments": {
    "node_id": "4472:98012",
    "use_chunking": true,
    "chunk_size": 50
  }
}

Экспорт как изображение

{
  "tool": "export_node_as_image",
  "arguments": {
    "node_id": "4472:98013",
    "format": "PNG",
    "scale": 2.0
  }
}

🔧 Конфигурация

WebSocket Server

Порт: 3055 (по умолчанию)
Host: localhost
Debug режим: --debug

MCP Server

Server URL: localhost:3055 (по умолчанию)
Протокол: MCP 2024-11-05
Transport: stdio

📁 Структура проекта

python-version/
├── src/figma_mcp/
│   ├── __init__.py
│   ├── server.py          # Главный MCP сервер
│   ├── websocket_client.py # WebSocket клиент
│   ├── types.py           # Типы Pydantic
│   └── utils.py           # Утилиты
├── tests/                 # Тесты (41 тест)
├── websocket_proxy.py     # WebSocket сервер
├── requirements.txt       # Зависимости
└── README.md             # Документация

🧪 Тестирование

Запуск всех тестов:

python -m pytest tests/ -v

Тестирование подключения:

python test_mcp.py

🔒 Безопасность

Фильтрация конфиденциальных данных из ответов Figma
Валидация всех параметров с Pydantic
Обработка ошибок и таймаутов
Логирование в stderr для отладки

📦 Зависимости

fastmcp: 2.4.0 - MCP сервер фреймворк
websockets: 15.0.1 - WebSocket клиент/сервер
pydantic: 2.11.5 - Валидация данных
pytest: 8.3.5 - Тестирование

🐛 Отладка

Проблемы с подключением: Проверьте статус WebSocket сервера
Таймауты: Увеличьте timeout в WebSocket клиенте
Ошибки каналов: Убедитесь, что используете правильный Channel ID
Логи: Смотрите вывод в stderr для детальной информации

📝 Лицензия

MIT License

🤝 Вклад

Форкните репозиторий
Создайте ветку для функции
Добавьте тесты
Отправьте pull request

This server cannot be installed

security - not tested

license - not found

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Python implementation of the Model Context Protocol server that enables AI assistants to interact with Figma through WebSocket connections, allowing them to read, analyze, and export design data.

Related MCP Servers

mcp-figma
smithery-ai
A
security
F
license
A
quality
A Model Context Protocol server that provides access to Figma API functionality, allowing AI assistants like Claude to interact with Figma files, comments, components, and team resources.
Last updated -
18
34
1
MCP Python Toolbox
gianlucamazza
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
Last updated -
1
Python
MCP Server for Slack
z9905080
-
security
A
license
-
quality
A Model Context Protocol server implementation that enables AI assistants to interact with Slack workspaces, allowing them to browse channels, send messages, reply to threads, add reactions, and retrieve user information.
Last updated -
18
JavaScript
Apache 2.0
Figma MCP Server
1yhy
-
security
A
license
-
quality
A Model Context Protocol server that integrates Figma design files with AI coding tools like Cursor, Windsurf, and Cline, allowing AI tools to access and understand Figma design data for generating more accurate code.
Last updated -
124
6
TypeScript
MIT License

View all related MCP servers