Каталог MCP
automatelab-tech

AutomateLab-tech/n8n-mcp

MCP-сервер для n8n, который даёт AI-агентам инструменты генерации, линтинга и диагностики workflow. Помогает быстро создавать корректные workflow, отлавливать ошибки выполнения и управлять live-экз...

README

12 инструментов

Установить сервер

n8n-mcp

An MCP server for n8n that gives Claude, Cursor, and other AI agents tools for generating workflows, linting, diagnosing failed executions, and driving live n8n instances.

Why we built this

We use n8n daily inside AutomateLab and kept hitting the same LLM failures: workflow JSON that imports but fails at runtime, AI Agent clusters wired with the wrong connection types, executions that silently drop items with no clue where to look. Dumping the whole n8n catalog into context doesn't fix it - the failure modes are too subtle (typeVersion mismatches, IF v1 schema, credentials that don't survive import).

So we built a small, focused server: encode the failure modes the lint can catch, the cluster topology the generator must respect, and the diagnosis the agent can't do alone. For a walkthrough of the nine tools with example output, see the launch post on automatelab.tech.

Why it's different

Other n8n MCP servers (notably czlonkowski/n8n-mcp) compete on breadth - 20+ tools and an indexed corpus of every n8n node. They own that niche.

execution_explainтолько чтениеидемпотентный

Диагностирует неудачное или неожиданное выполнение n8n. Вставьте JSON выполнения (из интерфейса n8n «Show details» или `GET /executions/:id?includeData=true`); возвращает сводку по каждому узлу с подсветкой узлов, вернувших 0 элементов, неразрешённых выражений `={{ ... }}`, ошибок с подсказками и использования токенов LLM. Затрагивает самую частую боль при отладке: элементы «бесшумно исчезают» между узлами. Детерминированный, основанный на правилах.

Explain a failed n8n execution

Параметры

executionanyобязательный
n8n execution payload (REST `?includeData=true` shape or raw UI export). Object or JSON string.

execution_listтолько чтениеидемпотентныйвнешний мир

Выводит список последних выполнений из активного экземпляра n8n (требуются N8N_API_URL и N8N_API_KEY). Фильтруйте по workflowId, статусу (success|error|waiting), лимиту. Передайте `includeData: true`, чтобы получить полное тело выполнения (большое) — используйте вместе с execution_explain для диагностики конкретной ошибки.

List recent n8n executions

Параметры

workflowIdstring
Filter by workflow ID.
statusenum
Filter by status: success | error | waiting.
successerrorwaiting
limitinteger
Page size (n8n default: 100, max: 250).
includeDataboolean
Include full execution data (large). Default false — pair with execution_explain.

execution_replayтолько чтениеидемпотентный

Создай самодостаточный воркфлоу для повтора, который отрабатывает одну ноду из большого воркфлоу. Воркфлоу для повтора выглядит так: Manual Trigger -> Replay Seed (нода Code с закреплёнными элементами) -> целевая нода. Опциональные `inputItems` или полезная нагрузка `execution` фиксируют то, что видит целевая нода. Это полезно для итерации по одной упрямой ноде без повторного запуска всего пайплайна. Возвращает JSON воркфлоу, готовый для импорта или отправки через workflow_create.

Build a replay workflow for one node

Параметры

workflowanyобязательный
Original workflow JSON.
nodestringобязательный
Name of the node to replay.
inputItemsobject[]
Optional explicit input items (each becomes `{ json: ... }`).
executionany
Optional execution payload — pulls real input the target saw last time.

execution_timelineтолько чтениеидемпотентный

Рендерит выполнение n8n как временную шкалу по узлам: смещение старта, длительность, элементы на входе/выходе, флаг ошибки. Дополняет execution_explain — тот показывает *почему*, этот показывает *когда*. Результат — таблица в Markdown, отсортированная по времени старта. Детерминированно.

Render an execution as a per-node timeline

Параметры

executionanyобязательный
n8n execution payload (must include `data.resultData.runData`).

node_scaffoldтолько чтение

Создай каркас TypeScript для пользовательского узла n8n из описания на простом английском. Возвращает один файл TypeScript, реализующий INodeType с описанием, ссылкой на учётные данные и заглушкой метода execute. Чистая генерация кода — без сети, без записи в файловую систему.

Scaffold an n8n custom node

Параметры

descriptionstringобязательный
Plain-English description of what the node should do (1+ chars).
nodeNamestring
Optional PascalCase class name, e.g. 'DiscordRateLimited'. Derived from the description if omitted.

workflow_activateидемпотентныйвнешний мир

Активирует или деактивирует рабочий процесс (workflow) на активном экземпляре n8n (требуется N8N_API_URL + N8N_API_KEY). Передайте `active: false` для деактивации. Идемпотентно - повторная активация уже активного рабочего процесса не вызывает никаких изменений на стороне n8n.

Activate or deactivate a workflow

Параметры

idstringобязательный
Workflow ID.
activeboolean
Defaults to true (activate). Set false to deactivate.

workflow_createвнешний мир

Создаёт workflow на работающем экземпляре n8n (требуется N8N_API_URL + N8N_API_KEY). Удаляет поля только для чтения (id, active, createdAt, ...) перед отправкой. Workflows создаются неактивными — после этого вызывайте workflow_activate. Сочетается с workflow_generate для сквозного процесса 'describe -> deploy'.

Create a workflow on a live n8n instance

Параметры

workflowanyобязательный
Workflow JSON to create (typically the output of workflow_generate). Either a parsed object or a JSON string.

workflow_diffтолько чтениеидемпотентный

Семантический diff между двумя workflow. Сообщает о добавленных, удаленных и измененных узлах (с поузловыми изменениями: type, typeVersion, parameters, credentials, disabled, position), об изменениях топологии соединений и расхождении настроек. Игнорирует шум (небольшие смещения позиции, createdAt/updatedAt). Используйте вместе с workflow_get, чтобы сравнить развернутую версию с локальной. Детерминирован.

Semantic diff between two n8n workflows

Параметры

beforeanyобязательный
The 'before' workflow JSON.
afteranyобязательный
The 'after' workflow JSON.

workflow_generateтолько чтение

Генерирует корректный JSON-код рабочего процесса n8n по описанию на простом английском. Обрабатывает триггеры вебхуков, планировщика и RSS, общие узлы действий (Slack, Google Sheets, Discord, Gmail, Notion, HTTP) и настройки AI-агентов (корневой агент LangChain + модель чата + память + опциональный HTTP-инструмент, связанные через ai_languageModel / ai_memory / ai_tool соединения). Возвращает JSON рабочего процесса с уникальными ID узлов, связями, позициями и typeVersion на каждом узле. Вывод недетерминирован (случайные ID узлов и пути вебхуков).

Generate an n8n workflow from a description

Параметры

descriptionstringобязательный
Plain-English workflow description, e.g. 'Stripe webhook -> Slack message + Google Sheets row'.
namestring
Optional workflow name. Derived from the first sentence of the description if omitted.

workflow_getтолько чтениеидемпотентныйвнешний мир

Получает один workflow JSON по id из работающего экземпляра n8n (требуются N8N_API_URL + N8N_API_KEY). Возвращает полный набор узлов/соединений. Используйте вместе с workflow_lint для аудита развернутого workflow.

Fetch a single workflow by ID

Параметры

idstringобязательный
Workflow ID.

workflow_lintтолько чтениеидемпотентный

Линтует JSON-схему n8n workflow. Возвращает конкретные ошибки и предупреждения: отсутствующие учётные данные, устаревшие типы узлов (Function -> Code, spreadsheetFile -> convertToFile/extractFromFile), разорванные соединения, отсутствующий или нечисловой typeVersion, повторяющиеся имена или ID узлов, AI Agent без подузла ai_languageModel, Webhook без webhookId, узел IF всё ещё на схеме условий v1, чувствительные к ограничениям узлы без повторных попыток, нарушения песочницы узла Code, устаревшие выражения (`$('NodeName')` ссылается на отсутствующие узлы), manualTrigger в активных workflow, отключённые, но подключённые узлы, пустые узлы Set, несоответствия HTTP метода и тела, риск перехода на летнее время триггера Schedule, расхождение учётных данных, тестовые пути webhook в активных workflow. Детерминировано, на основе правил.

Lint an n8n workflow JSON

Параметры

workflowanyобязательный
n8n workflow as either a parsed object or a JSON string (will be parsed).

workflow_listтолько чтениеидемпотентныйвнешний мир

Перечисляет рабочие процессы из живого экземпляра n8n (требуются переменные окружения N8N_API_URL + N8N_API_KEY). Возвращает id, name, active, nodeCount, updatedAt, tags. Фильтровать по active, tags, name. Используйте это, когда пользователь спрашивает «какие у меня workflows?» или перед workflow_get.

List workflows on a live n8n instance

Параметры

activeboolean
Filter by active status. Omit to return both.
tagsstring
Comma-separated tag names to filter by.
namestring
Filter by exact workflow name.
limitinteger
Page size (n8n default: 100, max: 250).

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@automatelab/n8n-mcp"
  ],
  "env": {
    "N8N_API_URL": "https://your-n8n.example.com",
    "N8N_API_KEY": "n8n_..."
  }
}

Также AutomateLab-tech/n8n-mcp можно установить в Cursor по ссылке автоматически.

FAQ

Для чего этот сервер?

Этот MCP-сервер решает проблему, когда AI-агенты генерируют n8n-воркфлоу, которые импортируются, но ломаются в рантайме. Он ловит тихие ошибки — неправильные соединения, устаревшие узлы, потерянные данные между шагами. Проверяет топологию AI Agent, чтобы кластеры LangChain импортировались чисто. А если выполнение упало, объясняет на пальцах, что пошло не так и где копать. Полезен всем, кто автоматизирует через n8n с помощью ИИ.

Что он умеет?

Генерирует workflow и шаблоны кастомных нод на TypeScript по текстовому описанию, линтит их на ошибки, deprecated-типы и сломанные соединения, показывает семантическую разницу между версиями. Диагностирует провальные выполнения — разбирает по нодам, строит replay-воркфлоу для одной ноды и временную шкалу. Через API управляет экземпляром: список, чтение, создание, включение/отключение workflow, просмотр журнала выполнений.

Информация о сервере

Номер в рейтинге: #184
Звезд на Github: 12
Форков на Github: 0
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 16.07 в 22:29
Идентификатор: _NPfibTvAdq48DQP
Категории: CI/CD и DevOps, Автоматизация приложений, Агенты, Агенты для программирования, Анализ кода, ИИ и машинное обучение, Инструменты для разработчиков, Тестирование и QA

Другие проверенные MCP-сервера

confluentinc/mcp-confluent

официальный

MCP-сервер для управления Confluent Cloud и Kafka через естественный язык. Включает 50+ инструментов для работы с топиками, Flink SQL, Schema Registry, коннекторами и метриками. Подходит для Claude Desktop, VS Code и других MCP-клиентов.

lpigeon/ros-mcp-server

MCP сервер для ROS соединяет LLM (Claude, GPT, Gemini) с роботами в реальном времени. Позволяет управлять, читать сенсоры и вызывать сервисы без изменения исходного кода. Полезен робототехникам и разработчикам AI для двустороннего взаимодействия с железом.

chrishayuk/mcp-cli

MCP CLI — интерфейс командной строки для взаимодействия с MCP-серверами. Позволяет общаться с LLM, выполнять инструменты, строить исполняемые планы и управлять контекстом через виртуальную память. ...

jsdelivr/globalping-mcp-server

официальный

Globalping MCP Server даёт AI-ассистентам доступ к глобальной сети проб для выполнения сетевых тестов (ping, traceroute, DNS, HTTP) из тысяч точек мира. Идеально для диагностики сети и сравнения пр...

can4hou6joeng4/boss-agent-cli

BOSS Agent CLI — 为 AI Agent 设计的 BOSS 直聘本地辅助工具。支持职位搜索、福利筛选（双休、五险一金等）、候选池管理，输出 JSON 信封。默认低风险只读模式，合规安全，适合求职者与招聘者。

PSPDFKit/nutrient-document-engine-mcp-server

официальный

MCP-сервер для обработки документов на естественном языке. Подключает AI-агентов к извлечению текста, редактированию и рецензированию PDF, а также безопасному сокрытию конфиденциальных данных. Поле...