Сервер протокола контекста модели (MCP) для создания и изменения рабочих процессов n8n. Создавайте рабочие процессы n8n с помощью ИИ — работает с Claude Code, VS Code, Cursor и любым клиентом, поддерживающим MCP.
Файл с правилами находится в rules/n8n-mcp-server-rules.mdc
Related MCP server: MCP- N8N
Управление рабочими процессами: Программное создание, обновление и выполнение рабочих процессов n8n (выполнение пока не реализовано)
Обнаружение узлов: Изучение доступных узлов n8n и их возможностей
Управление соединениями: Создание связей между узлами рабочего процесса
Интеграция с ИИ: Специальные инструменты для подключения компонентов ИИ в рабочих процессах
Интерфейс, удобный для ИИ: Разработан специально для взаимодействия с ИИ-агентами
Управление версиями N8N: Автоматическое определение версии и обработка совместимости — поддерживает 184+ версии n8n (1.86.0 – 2.6.2) с динамической фильтрацией узлов и сопоставлением с «ближайшей младшей версией» для обеспечения обратной совместимости
Node.js (v18 или выше)
npm (для команды npx)
Клиент, поддерживающий MCP (Claude Code, VS Code, Cursor и т.д.)
Откройте ваш экземпляр n8n в браузере
Перейдите в Settings > API Keys
Нажмите Create API Key
Скопируйте созданный ключ и используйте его в своей конфигурации
Добавьте MCP-сервер с помощью CLI Claude Code:
claude mcp add n8n-workflow-builder -- npx -y n8n-workflow-builder-mcpЗатем установите переменные окружения:
claude mcp add n8n-workflow-builder \
-e N8N_API_URL=http://localhost:5678 \
-e N8N_API_KEY=your-n8n-api-key-here \
-- npx -y n8n-workflow-builder-mcp
N8N_VERSIONявляется необязательным — сервер автоматически определяет его через API.
Добавьте в ваш файл конфигурации MCP (.vscode/mcp.json для VS Code, .cursor/mcp.json для Cursor):
{
"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"
}
}
}
}Перезапустите IDE, чтобы изменения вступили в силу.
Для разработки или локального тестирования клонируйте и соберите проект из исходного кода:
git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git
cd n8n-workflow-builder-mcp
npm install
npm run buildЗатем укажите вашему MCP-клиенту путь к собранной точке входа:
# Claude Code
claude mcp add n8n-workflow-builder -- node /absolute/path/to/n8n-workflow-builder-mcp/dist/index.js
# VS Code / Cursor — use the same JSON config above with "command": "node" and "args": ["/absolute/path/to/dist/index.js"]Для разработки с автоматической пересборкой:
npm run devСервер предоставляет следующие инструменты для работы с рабочими процессами n8n:
Название инструмента | Описание | Ключевые параметры |
create_workflow | Создать новый рабочий процесс n8n |
|
list_workflows | Список рабочих процессов в рабочей директории |
|
get_workflow_details | Получить подробную информацию о конкретном рабочем процессе |
|
validate_workflow | Проверить файл рабочего процесса на соответствие схемам узлов и связность |
|
Название инструмента | Описание | Ключевые параметры |
add_node | Добавить новый узел в рабочий процесс |
|
edit_node | Редактировать существующий узел в рабочем процессе |
|
delete_node | Удалить узел из рабочего процесса |
|
list_available_nodes | Список доступных типов узлов с опциональной фильтрацией. Поддерживает синонимы в стиле тегов и логику OR/AND для нескольких токенов |
|
Название инструмента | Описание | Ключевые параметры |
add_connection | Создать соединение между двумя узлами |
|
add_ai_connections | Подключить ИИ-модель, инструменты и память к агенту |
|
connect_main_chain | Построить минимальный основной путь через узлы ИИ-рабочего процесса (Триггер → Модель → Память → Эмбеддинги → Загрузчик документов → Векторное хранилище → Векторный инструмент → Агент) |
|
Название инструмента | Описание | Ключевые параметры |
plan_workflow | Создать неразрушающий план (узлы и соединения) для обновления рабочего процесса. Не записывает файлы |
|
review_workflow_plan | Применить план в памяти и вернуть ошибки валидации, предупреждения и предложенные исправления. Не записывает файлы |
|
apply_workflow_plan | Применить ранее проверенный план к рабочему процессу на диске (атомарная запись) |
|
compose_ai_workflow | Создать сложный ИИ-рабочий процесс (агент + модель + память + эмбеддинги + вектор + инструменты + триггер) за один вызов, включая связывание и базовую валидацию |
|
Название инструмента | Описание | Ключевые параметры |
suggest_node_params | Предложить минимальные допустимые параметры для типа узла, используя значения по умолчанию и обязательные поля |
|
list_missing_parameters | Список обязательных параметров, отсутствующих для узла, с учетом правил видимости |
|
fix_node_params | Вернуть параметры с примененными значениями по умолчанию для отсутствующих обязательных полей |
|
Название инструмента | Описание | Ключевые параметры |
list_template_examples | Список примеров использования узлов, извлеченных из бесплатных шаблонов. Фильтрация по node_type или template_name |
|
get_n8n_version_info | Получить текущую версию N8N и возможности |
|
validate_workflow повышает уровень предупреждений до ошибок и дополнительно выдает ошибку, если какой-либо активный узел не подключен (напрямую или через порты ИИ) к основной цепочке, начинающейся с предполагаемого startNode. Используйте connect_from/connect_to или add_ai_connections для исправления связности.
Проверьте вашу конфигурацию MCP — убедитесь, что JSON валиден и имя сервера совпадает.
Обновите Node.js до последней версии LTS.
Очистите кэш npm, если npx выдает ошибку: npm cache clean --force
Попробуйте глобальную установку в качестве запасного варианта: npm install -g n8n-workflow-builder-mcp
Выполните claude mcp list, чтобы убедиться, что сервер зарегистрирован.
Проверьте логи с помощью claude mcp logs n8n-workflow-builder.
Проверьте панель вывода (Output) — выберите "MCP" в выпадающем списке, чтобы увидеть логи сервера.
Убедитесь, что сервер включен в Settings > Features > MCP Servers.
Перезапустите IDE после внесения изменений в конфигурацию.
/src: Основной исходный код
/src/tools: Реализация инструментов MCP
/src/models: Модели данных
/src/utils: Вспомогательные функции
/src/middleware: Аутентификация и промежуточное ПО
/config: Файлы конфигурации
/tests: Файлы тестов
/workflow_nodes: Определения узлов n8n
/docs: Дополнительная документация
Вклад приветствуется! Пожалуйста, не стесняйтесь отправлять Pull Request.
Сделайте форк репозитория
Создайте ветку для вашей функции (git checkout -b feature/amazing-feature)
Зафиксируйте изменения (git commit -m 'Add some amazing feature')
Отправьте изменения в ветку (git push origin feature/amazing-feature)
Откройте Pull Request
MIT License
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Create, browse, remix, collaborate on, and run durable AI workflow nodes from MCP hosts.
Your saved nanoodle workflow graphs as MCP tools — BYOK or pay per call in Nano (x402)
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ifmelate/n8n-workflow-builder-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server