Claude Info
Dev-инструменты

n8n-MCP

czlonkowski/n8n-mcp

MCP-сервер, предоставляющий ИИ-ассистентам полный доступ к документации, свойствам и операциям 1505 узлов n8n. Поддерживает Claude, Cursor, Windsurf и другие IDE. Включает библиотеку из 2709 шаблонов воркфлоу и 693 узла сообщества.

Подключение

terminal
bash
git clone https://github.com/czlonkowski/n8n-mcp.git

README

n8n-MCP

License: MIT GitHub stars npm version codecov Tests n8n version Docker Deploy on Railway

MCP-сервер (Model Context Protocol), предоставляющий ИИ-ассистентам полный доступ к документации, свойствам и операциям узлов n8n. Разворачивается за несколько минут и даёт Claude и другим ИИ-ассистентам глубокие знания о 1505 узлах автоматизации n8n (812 основных + 693 от сообщества).

Обзор

n8n-MCP служит мостом между платформой автоматизации n8n и ИИ-моделями, позволяя им эффективно понимать узлы n8n и работать с ними. Сервер предоставляет структурированный доступ к:

  • 1505 узлам n8n — 812 основных + 693 от сообщества (605 верифицированных)
  • Свойствам узлов — покрытие 99% с детальными схемами
  • Операциям узлов — покрытие 63,6% доступных действий
  • Документации — покрытие 87% из официальной документации n8n (включая AI-узлы)
  • AI-инструментам — 265 AI-совместимых вариантов инструментов с полной документацией
  • Реальным примерам — 2646 предварительно извлечённых конфигураций из популярных шаблонов
  • Библиотеке шаблонов — 2709 шаблонов воркфлоу со 100% покрытием метаданных
  • Узлам сообщества — поиск верифицированных интеграций через фильтр source

Поддержка проекта

n8n-mcp начинался как личный инструмент, но теперь помогает десяткам тысяч разработчиков эффективно автоматизировать воркфлоу. Поддержка и развитие проекта конкурируют с оплачиваемой работой. Ваше спонсорство помогает уделять время новым функциям, оперативно реагировать на проблемы, поддерживать документацию в актуальном состоянии и обеспечивать совместимость с последними версиями n8n. Стать спонсором

Важное предупреждение о безопасности

НИКОГДА не редактируйте рабочие воркфлоу напрямую с помощью ИИ! Всегда:

  • Делайте копию воркфлоу перед использованием ИИ-инструментов
  • Сначала тестируйте в среде разработки
  • Экспортируйте резервные копии важных воркфлоу
  • Проверяйте изменения перед развёртыванием в продакшн

Результаты работы ИИ могут быть непредсказуемы. Защищайте свою работу!

Быстрый старт

Самый быстрый способ попробовать n8n-MCP — без установки и настройки:

dashboard.n8n-mcp.com

  • Бесплатный уровень: 100 вызовов инструментов в день
  • Мгновенный доступ: начните строить воркфлоу сразу
  • Всегда актуально: последние узлы и шаблоны n8n
  • Без инфраструктуры: мы берём всё на себя

Просто зарегистрируйтесь, получите API-ключ и подключите MCP-клиент.

Хотите самостоятельно развернуть? Смотрите руководство по самостоятельному развёртыванию с вариантами через npx, Docker, Railway и локальную установку.

Интеграция с n8n

Хотите использовать n8n-MCP со своим экземпляром n8n? Ознакомьтесь с подробным руководством по развёртыванию n8n:

  • Локальное тестирование с узлом MCP Client Tool
  • Развёртывание в продакшн с Docker Compose
  • Облачное развёртывание на Hetzner, AWS и других провайдерах
  • Устранение неполадок и лучшие практики безопасности

Подключение IDE

n8n-MCP работает с несколькими ИИ-средами разработки и инструментами:

  • Claude Code — быстрая настройка для Claude Code CLI
  • Visual Studio Code — VS Code с интеграцией GitHub Copilot
  • Cursor — пошаговая настройка Cursor IDE
  • Windsurf — интеграция Windsurf с правилами проекта
  • Codex — руководство по интеграции Codex
  • Antigravity — руководство по интеграции Antigravity

Добавление навыков Claude (опционально)

Усильте построение воркфлоу n8n с помощью специализированных навыков, которые обучают ИИ создавать готовые к продакшн воркфлоу!

n8n-mcp Skills Setup

Подробнее: репозиторий n8n-skills

Настройка Claude Project

Для наилучших результатов при использовании n8n-MCP с Claude Projects используйте следующие расширенные системные инструкции:

markdown
Вы — эксперт по программному обеспечению автоматизации n8n, использующий инструменты n8n-MCP. Ваша роль — проектировать, строить и валидировать воркфлоу n8n с максимальной точностью и эффективностью.

## Основные принципы

### 1. Тихое выполнение
КРИТИЧНО: Выполняйте инструменты без комментариев. Отвечайте ТОЛЬКО после завершения всех инструментов.

### 2. Параллельное выполнение
Когда операции независимы, выполняйте их параллельно для максимальной производительности.

### 3. Сначала шаблоны
ВСЕГДА проверяйте шаблоны перед построением с нуля (доступно 2709 шаблонов).

### 4. Многоуровневая валидация
Используйте паттерн validate_node(mode='minimal') → validate_node(mode='full') → validate_workflow.

### 5. Никогда не доверяйте значениям по умолчанию
КРИТИЧНО: Значения параметров по умолчанию — источник ошибок №1 во время выполнения.
ВСЕГДА явно настраивайте ВСЕ параметры, управляющие поведением узла.

## Процесс работы с воркфлоу

1. **Старт**: вызовите `tools_documentation()` для получения лучших практик

2. **Фаза поиска шаблонов** (ПЕРВАЯ — параллельно при поиске нескольких)
   - `search_templates({searchMode: 'by_metadata', complexity: 'simple'})` — умная фильтрация
   - `search_templates({searchMode: 'by_nodes', nodeTypes: [...]})` — поиск по узлам

Похожие MCP-серверы