mcp-n8n-строитель
Сервер Model Context Protocol (MCP) для программного создания и управления рабочими процессами n8n. Этот сервер предоставляет инструменты и ресурсы для взаимодействия с REST API n8n, позволяя помощникам ИИ создавать, изменять и управлять рабочими процессами без прямого вмешательства пользователя.
Функции
- 🔄 Управление рабочими процессами : создание, чтение, обновление, удаление, активация и деактивация рабочих процессов.
- 📊 Управление выполнением : список и извлечение деталей выполнения рабочего процесса
- ✅ Проверка схемы : комплексная проверка с помощью Zod как входных, так и выходных данных
- 🔍 Проверка узлов : проверяет типы узлов на соответствие доступным узлам n8n перед созданием рабочего процесса для предотвращения ошибок.
- 🤔 Умные предложения : предлагает похожие типы узлов при обнаружении недействительных узлов.
- 🛠️ Обработка ошибок : подробные сообщения об ошибках для устранения неполадок
- 📝 Документация : обширная документация по всем инструментам и ресурсам
- 🔍 Поиск и фильтр : фильтрация рабочих процессов по имени, тегам или активному статусу.
Конфигурация
Этот сервер требует настройки через ваш клиент MCP. Вот примеры для разных сред:
Конфигурация Клайна
Добавьте это в настройки Cline MCP:
Claude Desktop с конфигурацией WSL
Для сред WSL добавьте это в конфигурацию Claude Desktop:
Переменные среды
Сервер можно настроить с помощью переменных среды:
Переменная | Описание | По умолчанию |
---|---|---|
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
: Список всех рабочих процессов в n8nn8n://workflows/{id}
: Подробная информация о конкретном рабочем процессе n8nn8n://executions/{id}
: Подробности выполнения конкретного рабочего процесса n8n
Разработка
Настраивать
- Клонировать репозиторий
- Установите зависимости:
- Создайте проект:
- Запустить в режиме разработки:
Издательский
Проект использует наборы изменений для управления версиями. Для публикации:
- Создайте набор изменений:
- Версия пакета:
- Опубликовать в npm:
Внося вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.
Лицензия
Лицензия MIT — подробности см. в файле LICENSE .
Благодарности
- Построен на основе протокола модельного контекста
- При поддержке n8n
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
🪄 Сервер MCP для программного создания и управления рабочими процессами n8n. Позволяет помощникам на основе ИИ создавать, изменять и управлять рабочими процессами без прямого вмешательства пользователя с помощью комплексного набора инструментов и ресурсов для взаимодействия с REST API n8n.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server enabling secure interaction with n8n workflows, executions, and settings via the Model Context Protocol, designed for integration with Large Language Models (LLMs).Last updated -336534TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol (MCP) server for programmatically creating and managing n8n workflows.Last updated -3MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants to interact with n8n workflows through natural language, supporting actions like listing, creating, updating, executing and monitoring workflows.Last updated -388464TypeScriptMIT License
- -securityFlicense-qualityA Master Control Program server that provides workflow validation tools and best practices for n8n automation projects, including workflow management, NextJS integration, and API access.Last updated -TypeScript