mcp-n8n-строитель

Сервер Model Context Protocol (MCP) для программного создания и управления рабочими процессами n8n. Этот сервер предоставляет инструменты и ресурсы для взаимодействия с REST API n8n, позволяя помощникам ИИ создавать, изменять и управлять рабочими процессами без прямого вмешательства пользователя.

Функции

🔄 Управление рабочими процессами : создание, чтение, обновление, удаление, активация и деактивация рабочих процессов.
📊 Управление выполнением : список и извлечение деталей выполнения рабочего процесса
✅ Проверка схемы : комплексная проверка с помощью Zod как входных, так и выходных данных
🔍 Проверка узлов : проверяет типы узлов на соответствие доступным узлам n8n перед созданием рабочего процесса для предотвращения ошибок.
🤔 Умные предложения : предлагает похожие типы узлов при обнаружении недействительных узлов.
🛠️ Обработка ошибок : подробные сообщения об ошибках для устранения неполадок
📝 Документация : обширная документация по всем инструментам и ресурсам
🔍 Поиск и фильтр : фильтрация рабочих процессов по имени, тегам или активному статусу.

Related MCP server: n8n Workflow Builder MCP Server

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

Этот сервер требует настройки через ваш клиент MCP. Вот примеры для разных сред:

Конфигурация Клайна

Добавьте это в настройки Cline MCP:

{ "mcpServers": { "n8n-workflow-builder": { "command": "npx", "args": ["-y", "mcp-n8n-builder"], "env": { "N8N_HOST": "http://localhost:5678/api/v1", "N8N_API_KEY": "your-n8n-api-key", "OUTPUT_VERBOSITY": "concise" // Options: 'concise' or 'full' } } } }

Claude Desktop с конфигурацией WSL

Для сред WSL добавьте это в конфигурацию Claude Desktop:

{ "mcpServers": { "n8n-workflow-builder": { "command": "wsl.exe", "args": [ "bash", "-c", "N8N_HOST=http://localhost:5678/api/v1 N8N_API_KEY=your-n8n-api-key OUTPUT_VERBOSITY=concise npx -y mcp-n8n-builder" ] } } }

Переменные среды

Сервер можно настроить с помощью переменных среды:

Переменная	Описание	По умолчанию
`N8N_HOST`	URL API n8n	`http://localhost:5678/api/v1`
`N8N_API_KEY`	API-ключ для аутентификации n8n	`""`
`SERVER_NAME`	Имя MCP-сервера	`"n8n-workflow-builder"`
`SERVER_VERSION`	Версия сервера MCP	Версия пакета
`LOG_LEVEL`	Уровень ведения журнала	`"info"`
`CACHE_ENABLED`	Включить кэширование	`false`
`CACHE_TTL`	TTL кэша в секундах	`300`
`OUTPUT_VERBOSITY`	Уровень детализации вывода ( `concise` или `full` )	`"concise"`

Инструменты МКП

Управление узлом

list_available_nodes : Перечисляет все доступные узлы в экземпляре n8n. ВАЖНО : Используйте этот инструмент ПЕРЕД созданием или обновлением рабочих процессов, чтобы убедиться, что вы используете только допустимые типы узлов. Это помогает предотвратить ошибки, вызванные использованием типов узлов, которые не существуют в текущем экземпляре n8n.

Управление рабочим процессом

list_workflows : Перечисляет все рабочие процессы из n8n с их базовой информацией, включая ID, имя, статус, дату создания и теги. Результаты можно фильтровать по активному статусу, тегам или имени.
create_workflow : Создает новый рабочий процесс в n8n с указанными узлами и соединениями. Возвращает созданный рабочий процесс с назначенным ему идентификатором. Проверяет, что все типы узлов существуют в экземпляре n8n.
get_workflow : извлекает полную информацию о конкретном рабочем процессе по его идентификатору, включая все узлы, соединения, настройки и метаданные.
update_workflow : Обновляет существующий рабочий процесс с новой конфигурацией. Должна быть предоставлена вся структура рабочего процесса, а не только изменяемые части. Проверяет, что все типы узлов существуют в экземпляре n8n.
delete_workflow : Окончательно удаляет рабочий процесс по его идентификатору. Это действие не может быть отменено.
activate_workflow : активирует рабочий процесс по его идентификатору, позволяя ему запускаться автоматически в зависимости от его триггера.
deactivate_workflow : деактивирует рабочий процесс по его идентификатору, предотвращая его автоматический запуск.

Управление исполнением

list_executions : Перечисляет историю выполнения рабочего процесса с подробностями о статусе успеха/неудачи, продолжительности и временных метках. Результаты можно фильтровать по идентификатору рабочего процесса, статусу и ограничивать определенным числом.
get_execution : получает подробную информацию о выполнении конкретного рабочего процесса, включая время выполнения, статус и, при необходимости, полные данные, обработанные на каждом этапе.

Ресурсы МКП

n8n://workflows : Список всех рабочих процессов в n8n
n8n://workflows/{id} : Подробная информация о конкретном рабочем процессе n8n
n8n://executions/{id} : Подробности выполнения конкретного рабочего процесса n8n

Разработка

Настраивать

Клонировать репозиторий
Установите зависимости:

npm install

Создайте проект:

npm run build

Запустить в режиме разработки:

npm run dev

Издательский

Проект использует наборы изменений для управления версиями. Для публикации:

Создайте набор изменений:

npm changeset

Версия пакета:

npm changeset version

Опубликовать в npm:

npm release

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Лицензия

Лицензия MIT — подробности см. в файле LICENSE .

Благодарности

Построен на основе протокола модельного контекста
При поддержке n8n

One-click Deploy

A

security – no known vulnerabilities

-

license - not tested

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

mcp-n8n-builder