MCP-сервер n8n-workflow-builder-mcp позволяет языковым моделям в режиме агента (Claude, Cursor, ChatGPT, Gemini) самостоятельно создавать и редактировать n8n-воркфлоу прямо в IDE — просто описывая задачу в чате.
Что такое n8n Workflow Builder MCP и зачем он нужен
n8n — популярная платформа автоматизации с визуальным редактором, которую используют тысячи команд по всему миру. Но даже с удобным интерфейсом сборка сложных воркфлоу из десятков нод требует времени. Проект n8n-workflow-builder-mcp от разработчика ifmelate решает эту проблему радикально: он реализует Model Context Protocol (MCP) — открытый стандарт интеграции LLM с внешними инструментами — и позволяет AI-агенту строить готовые JSON-воркфлоу по вашему текстовому описанию.
Результат — файл JSON, который можно скопировать и вставить прямо в редактор n8n. Никакого написания кода вручную, никакой настройки нод «по кнопкам».
Как это работает
Сервер запускается локально и подключается к вашему экземпляру n8n через API. LLM-агент (например, Claude 3.7 Sonnet внутри Cursor IDE) получает доступ к набору инструментов MCP и может:
- Создавать новые воркфлоу с нуля
- Добавлять, редактировать и удалять ноды
- Выстраивать соединения между нодами, включая AI-цепочки
- Валидировать итоговый воркфлоу перед применением
- Искать доступные типы нод с поддержкой 123+ версий n8n
Весь процесс идёт через чат: вы описываете нужную автоматизацию, агент поэтапно строит воркфлоу, используя инструменты сервера, и сохраняет результат в JSON-файл.
Ключевые возможности (инструменты MCP)
Управление воркфлоу
- create_workflow — создать новый воркфлоу
- list_workflows — просмотреть список воркфлоу в рабочей директории
- get_workflow_details — получить детали конкретного воркфлоу
- validate_workflow — проверить корректность файла: схемы нод, связность, обязательные параметры
Управление нодами
- add_node / edit_node / delete_node — полный CRUD для нод
- list_available_nodes — поиск доступных типов нод с поддержкой тегов и логики OR/AND, фильтрацией по версии n8n
Управление соединениями
- add_connection — соединить две ноды
- add_ai_connections — автоматически подключить модель, инструменты и память к AI-агенту
- connect_main_chain — построить минимальную основную цепочку AI-воркфлоу (Trigger → Model → Memory → Embeddings → Vector Store → Agent)
Планирование и композиция
- plan_workflow — создать план воркфлоу без записи файла
- review_workflow_plan — применить план в памяти, получить ошибки и рекомендации
- apply_workflow_plan — атомарно записать план на диск
- compose_ai_workflow — собрать полноценный AI-воркфлоу (агент + модель + память + эмбеддинги + векторное хранилище + инструменты + триггер) одной командой
Работа с параметрами
- suggest_node_params — предложить минимальные валидные параметры для ноды
- list_missing_parameters — найти обязательные незаполненные параметры
- fix_node_params — автоматически проставить значения по умолчанию для недостающих полей
Шаблоны и примеры
- list_template_examples — примеры использования нод из реальных шаблонов n8n
- get_n8n_version_info — информация о текущей версии n8n и её возможностях
Поддерживаемые AI-клиенты
Сервер совместим с большинством популярных инструментов, работающих с MCP:
- Cursor IDE
- VS Code
- Claude (Anthropic)
- ChatGPT
- Gemini
- Codex
Установка и настройка
Самый простой способ — через npx в конфигурационном файле Cursor IDE (.cursor/mcp.json):
{
"mcpServers": {
"n8n-workflow-builder": {
"command": "npx",
"args": ["-y", "n8n-workflow-builder-mcp"],
"env": {
"N8N_API_URL": "http://localhost:5678",
"N8N_API_KEY": "your-n8n-api-key-here"
}
}
}
}Этот метод автоматически загружает последнюю версию пакета, не требует глобальной установки и работает в любом окружении. Для получения API-ключа n8n перейдите в Settings → API Keys в вашем экземпляре n8n.
Минимальные требования: Node.js v14+, Cursor IDE v0.48+ (или другой MCP-совместимый клиент).
Текущие ограничения
Проект активно развивается, поэтому стоит учитывать несколько нюансов:
- LLM-агент иногда передаёт неверные параметры в запросах — разработчик работает над улучшением валидации
- Не все типы нод n8n протестированы и гарантированно работают
- Функция прямого запуска воркфлоу через MCP (execute) пока не реализована
Для кого это полезно
n8n-workflow-builder-mcp будет особенно полезен:
- Разработчикам AI-агентов, которые хотят автоматизировать построение сложных пайплайнов
- Командам автоматизации, работающим с n8n и желающим ускорить прототипирование
- No-code/low-code специалистам, которым удобнее описывать логику словами, а не кликами
- Исследователям MCP, изучающим практические сценарии применения протокола
Итог
n8n Workflow Builder MCP — интересный и практичный инструмент на пересечении двух трендов: роста экосистемы MCP и спроса на AI-assisted автоматизацию. Он позволяет буквально «разговаривать» с вашим n8n-экземпляром через языковую модель и получать готовые воркфлоу. При всей своей молодости проект уже работоспособен и продолжает активно развиваться — стоит поставить звёздочку на GitHub и следить за обновлениями.
