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

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

Функции

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

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

Этот сервер требует настройки через ваш клиент 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

mcp-n8n-builder

Integrations