n8n-mcp

n8n-mcp

AutomateLab-techMIT
7 звёзд
n8n-mcp — сервер для ИИ-агентов (Claude, Cursor), созданный для отладки и генерации рабочих процессов n8n. Разработчики AutomateLab сфокусировались на конкретной проблеме: сгенерированный JSON импортируется, но падает в рантайме. Сервер исправляет это. Это не очередная база знаний по n8n. Конкуренты делают упор на количество инструментов и обширный каталог узлов. n8n-mcp занимает другую нишу — корректность с первого запуска и глубокая отладка. Инструменты execution.explain, workflow.generate и workflow.lint заточены под самые частые проблемы n8n-сообщества: тихие падения, потеря данных между узлами, неверные типы соединений в AI Agent кластерах. Проект под MIT-лицензией, исходный код на GitHub. Если вы работаете с n8n и ИИ-агентами — это обязательный инструмент в вашем наборе.
DevelopmentFilesN8n
Открыть на GitHub

Установка

npx -y @automatelab/n8n-mcp

Характеристики

Общее

  • СтатусСообщество
  • РазработчикAutomateLab-tech
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Диагностика исполнения (execution.explain): загрузите JSON упавшего workflow — сервер укажет узлы с нулевым результатом, неразрешённые выражения и точные причины ошибки.
  • Генерация workflow (workflow.generate): создаёт готовые процессы с корректной топологией AI Agent. Узлы подключаются через правильные типы соединений (ai_languageModel, ai_memory, ai_tool), а не через main.
  • Линтинг (workflow.lint): проверяет процессы на скрытые дефекты. Находит устаревшие узлы (Function вместо Code), отсутствие языковой модели у агента, сломанные связи и неправильные версии схем.
  • Управление через REST: если настроены N8N_API_URL и N8N_API_KEY, сервер получает доступ к вашему экземпляру: просмотр, создание, активация процессов и загрузка исполнений.
  • Работа с живыми данными: инструменты lint и explain могут анализировать не просто JSON из чата, а реальные процессы из вашего n8n.
  • Глубокий анализ соединений: проверяет все типы связей, а не только main. Выявляет разрывы цепочек, которые обычно остаются незамеченными.
  • Agent Skill: к серверу прилагается инструкция, которая подсказывает модели, какой инструмент вызывать в каждой ситуации (хранится отдельно, чтобы не перегружать промпт).

Как подключить

Установка выполняется одним пакетом через npx. Никаких глобальных зависимостей, только Node.js.

1. Запустите сервер через npx:

npx -y @automatelab/n8n-mcp

2. Добавьте конфигурацию в ваш MCP-клиент. Пример для Claude Desktop:

{ "mcpServers": { "n8n": { "command": "npx", "args": ["-y", "@automatelab/n8n-mcp"], "env": { "N8N_API_URL": "https://ваш-n8n.домен", "N8N_API_KEY": "ваш-секретный-ключ" } } } }

3. Перезагрузите клиент. Если вам нужны только генерация и линтинг, переменные окружения указывать не обязательно. Основной функционал будет работать только с JSON, который вы передадите в диалоге.

Для работы с живым экземпляром n8n укажите адрес сервера и API-ключ в переменных окружения.

Примеры запросов

  • «Вот JSON неработающего workflow. Объясни, почему на четвёртом узле пустой вывод и где потерялись данные.»
  • «Сгенерируй workflow для обработки заявок: вебхук → AI Agent с памятью → база данных. Сделай все соединения корректными.»
  • «Загрузи все активные процессы из моего n8n и проверь их на ошибки с помощью линтера.»
  • «Проверь этот workflow на устаревшие узлы и исправь их автоматически.»
  • «Вот execution JSON неудачного запуска. Найди, где произошла потеря данных. Проверь, все ли узлы вернули ожидаемое количество элементов.»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Cursor и любые клиенты, поддерживающие MCP-протокол.
  • REST-инструменты требуют указания N8N_API_URL и N8N_API_KEY. Без них доступны только генерация, линтинг и диагностика по JSON.

Поделиться