n8n-mcp

Самый полный MCP сервер для n8n — 43 инструмента, 8 шаблонов промптов и 6 ресурсов для просмотра, охватывающих всю поверхность REST API n8n. Первая реализация на Python.

Предоставьте Claude (или любому другому AI-клиенту, совместимому с MCP) полный контроль над вашим экземпляром n8n: создавайте рабочие процессы, запускайте выполнения, управляйте учетными данными, запрашивайте таблицы данных, проводите аудит безопасности — и все это на естественном языке.

Основные моменты

• 43 инструмента MCP — Полный CRUD для рабочих процессов, выполнений, учетных данных, тегов, переменных и таблиц данных, а также административные операции, такие как аудит безопасности и обнаружение возможностей API

• Создание рабочих процессов с двойной проверкой — create_and_validate_workflow запускает 6-фазный конвейер: создание, проверка структуры, два прохода выполнения, проверка согласованности и вердикт PASS/FAIL

• Безопасность записи по умолчанию — Все мутирующие операции отключены, если вы явно не включите их с помощью N8N_MCP_WRITE_MODE=true

• 8 направляющих шаблонов промптов — Многошаговые AI-рабочие процессы для отладки, проверок работоспособности, обзоров безопасности, создания рабочих процессов с полным тестированием и многого другого

• Асинхронность и пагинация — Построен на httpx с автоматической пагинацией на основе курсоров и настраиваемыми тайм-аутами

Функции

Плюс 8 шаблонов промптов MCP и 6 ресурсов для просмотра.

Предварительные требования

• Python 3.10+

• Экземпляр n8n — локальный (Docker) или удаленный (облачный)

• API-ключ n8n — создается в настройках n8n

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

1. Клонирование и установка

git clone https://github.com/Siddharth0903/n8n-mcp.git
cd n8n-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. Запуск n8n (если он еще не запущен)

docker compose up -d

Это запустит n8n с PostgreSQL по адресу http://localhost:5678.

3. Получение API-ключа n8n

1. Откройте http://localhost:5678 в браузере

2. Завершите начальную настройку, если это новый экземпляр

3. Перейдите в Settings (значок шестеренки) > n8n API

4. Нажмите Create an API key

5. Скопируйте ключ

4. Настройка окружения

cp .env.example .env

Отредактируйте .env, указав свои значения:

N8N_MCP_BASE_URL=http://localhost:5678   # Your n8n URL
N8N_MCP_API_KEY=your-api-key-here        # The API key from step 3
N8N_MCP_WRITE_MODE=false                 # Set to 'true' to enable create/update/delete

5. Запуск сервера

n8n-mcp

MCP-сервер теперь запущен через stdio и готов к подключению любого MCP-клиента.

Интеграция с клиентами

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "n8n": {
      "command": "/absolute/path/to/your/.venv/bin/n8n-mcp",
      "env": {
        "N8N_MCP_BASE_URL": "http://localhost:5678",
        "N8N_MCP_API_KEY": "your-api-key-here",
        "N8N_MCP_WRITE_MODE": "true"
      }
    }
  }
}

Совет: Используйте полный абсолютный путь к бинарному файлу n8n-mcp внутри вашего virtualenv.

Claude Code (CLI)

claude mcp add n8n -- /absolute/path/to/your/.venv/bin/n8n-mcp

Или добавьте в файл .mcp.json вашего проекта:

{
  "mcpServers": {
    "n8n": {
      "command": "/absolute/path/to/your/.venv/bin/n8n-mcp",
      "env": {
        "N8N_MCP_BASE_URL": "http://localhost:5678",
        "N8N_MCP_API_KEY": "your-api-key-here",
        "N8N_MCP_WRITE_MODE": "true"
      }
    }
  }
}

Любой MCP-клиент

n8n-mcp использует стандартный транспорт MCP stdio. Любой совместимый с MCP клиент может подключиться, запустив бинарный файл n8n-mcp.

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

Все настройки задаются через переменные окружения (или файл .env):

Ресурсы MCP

Представления данных n8n в режиме только для чтения:

Промпты MCP

Направляющие многошаговые шаблоны, которые проводят AI через сложные операции:

Безопасность

• Режим записи по умолчанию ВЫКЛЮЧЕН — работают только операции чтения, пока вы явно не установите N8N_MCP_WRITE_MODE=true

• Секреты учетных данных никогда не раскрываются — API n8n возвращает только метаданные, никогда не возвращая значения секретов

• Проверка пути вебхука — предотвращает обход пути и SSRF-атаки

• Структурированные ответы об ошибках — каждая ошибка возвращает JSON с подсказками, а не необработанные исключения

• Тайм-ауты запросов — настраиваемые тайм-ауты предотвращают зависание соединений

Архитектура

Claude / MCP Client
        |
        v
  +-----------+
  |  n8n-mcp  |  FastMCP server (Python, async)
  |           |
  | 43 tools  |  Workflows, Executions, Credentials,
  | 6 rsrc    |  Tags, Variables, Data Tables, Admin
  | 8 prompts |
  +-----+-----+
        | httpx (async, paginated)
        v
  +-----------+
  |  n8n API  |  REST /api/v1
  +-----+-----+
        |
        v
  +-----------+
  | Workflows |
  |  & Data   |
  +-----------+

Разработка

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest -v

# Lint
ruff check src/ tests/

# Type check
mypy src/

Лицензия

MIT