Skip to main content
Glama

n8n MCP-сервер

Сервер протокола контекста модели (MCP), позволяющий помощникам на основе искусственного интеллекта взаимодействовать с рабочими процессами n8n посредством естественного языка.

Обзор

Этот сервер MCP предоставляет инструменты и ресурсы для помощников ИИ для управления рабочими процессами и выполнениями n8n. Он позволяет помощникам:

  • Перечисление, создание, обновление и удаление рабочих процессов

  • Активировать и деактивировать рабочие процессы

  • Выполнение рабочих процессов и мониторинг их статуса

  • Доступ к информации о рабочем процессе и статистике выполнения

Related MCP server: n8n MCP Server

Установка

Предпосылки

  • Node.js 18 или более поздняя версия

  • экземпляр n8n с включенным доступом API

Установить из npm

npm install -g n8n-mcp-server

Установить из источника

# Clone the repository
git clone https://github.com/leonardsellem/n8n-mcp-server.git
cd n8n-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Optional: Install globally
npm install -g .

Установка докера

Вы также можете запустить сервер с помощью Docker:

# Pull the image
docker pull leonardsellem/n8n-mcp-server

# Run the container with your n8n API configuration
docker run -e N8N_API_URL=http://your-n8n:5678/api/v1 \
  -e N8N_API_KEY=your_n8n_api_key \
  -e N8N_WEBHOOK_USERNAME=username \
  -e N8N_WEBHOOK_PASSWORD=password \
  leonardsellem/n8n-mcp-server

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

Создайте файл .env в каталоге, где вы будете запускать сервер, используя .env.example в качестве шаблона:

cp .env.example .env

Настройте следующие переменные среды:

Переменная

Описание

Пример

N8N_API_URL

Полный URL API n8n, включая /api/v1

http://localhost:5678/api/v1

N8N_API_KEY

API-ключ для аутентификации с помощью n8n

n8n_api_...

N8N_WEBHOOK_USERNAME

Имя пользователя для аутентификации через веб-перехватчик (если используются веб-перехватчики)

username

N8N_WEBHOOK_PASSWORD

Пароль для аутентификации через веб-перехватчик

password

DEBUG

Включить ведение журнала отладки (необязательно)

true или false

Генерация API-ключа n8n

  1. Откройте ваш экземпляр n8n в браузере.

  2. Перейдите в Настройки > API > Ключи API.

  3. Создайте новый ключ API с соответствующими разрешениями.

  4. Скопируйте ключ в ваш файл .env

Использование

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

Из установочного каталога:

n8n-mcp-server

Или, если установлено глобально:

n8n-mcp-server

Интеграция с помощниками на основе искусственного интеллекта

После сборки сервера ( npm run build ) вам нужно настроить вашего помощника AI (например, VS Code с расширением Claude или приложение Claude Desktop) для его запуска. Обычно это включает в себя редактирование файла конфигурации JSON.

Пример конфигурации (например, в VS Code settings.json или Claude Desktop claude_desktop_config.json ):

{
  "mcpServers": {
    // Give your server a unique name
    "n8n-local": {
      // Use 'node' to execute the built JavaScript file
      "command": "node",
      // Provide the *absolute path* to the built index.js file
      "args": [
        "/path/to/your/cloned/n8n-mcp-server/build/index.js"
        // On Windows, use double backslashes:
        // "C:\\path\\to\\your\\cloned\\n8n-mcp-server\\build\\index.js"
      ],
      // Environment variables needed by the server
      "env": {
        "N8N_API_URL": "http://your-n8n-instance:5678/api/v1", // Replace with your n8n URL
        "N8N_API_KEY": "YOUR_N8N_API_KEY", // Replace with your key
        // Add webhook credentials only if you plan to use webhook tools
        // "N8N_WEBHOOK_USERNAME": "your_webhook_user",
        // "N8N_WEBHOOK_PASSWORD": "your_webhook_password"
      },
      // Ensure the server is enabled
      "disabled": false,
      // Default autoApprove settings
      "autoApprove": []
    }
    // ... other servers might be configured here
  }
}

Ключевые моменты:

  • Замените /path/to/your/cloned/n8n-mcp-server/ на фактический абсолютный путь, по которому вы клонировали и построили репозиторий.

  • Используйте правильный разделитель пути для вашей операционной системы (прямую косую черту / для macOS/Linux, двойную обратную косую черту \\ для Windows).

  • Убедитесь, что вы указали правильный N8N_API_URL (включая /api/v1 ) и N8N_API_KEY .

  • Сервер необходимо собрать ( npm run build ), прежде чем помощник сможет запустить файл build/index.js .

Доступные инструменты

Сервер предоставляет следующие инструменты:

Использование веб-хуков

Этот сервер MCP поддерживает выполнение рабочих процессов через веб-перехватчики n8n. Чтобы использовать эту функциональность:

  1. Создайте рабочий процесс, запускаемый с помощью веб-перехватчика, в n8n.

  2. Настройте базовую аутентификацию на узле вебхука.

  3. Используйте инструмент run_webhook для запуска рабочего процесса, передав только имя рабочего процесса.

Пример:

const result = await useRunWebhook({
  workflowName: "hello-world", // Will call <n8n-url>/webhook/hello-world
  data: {
    prompt: "Hello from AI assistant!"
  }
});

Аутентификация webhook выполняется автоматически с использованием переменных среды N8N_WEBHOOK_USERNAME и N8N_WEBHOOK_PASSWORD .

Управление рабочим процессом

  • workflow_list : Список всех рабочих процессов

  • workflow_get : Получить сведения о конкретном рабочем процессе

  • workflow_create : Создать новый рабочий процесс

  • workflow_update : обновить существующий рабочий процесс

  • workflow_delete : Удалить рабочий процесс

  • workflow_activate : Активировать рабочий процесс

  • workflow_deactivate : Деактивировать рабочий процесс

Управление исполнением

  • execution_run : выполнение рабочего процесса через API

  • run_webhook : выполнение рабочего процесса через веб-хук

  • execution_get : Получить сведения о конкретном исполнении

  • execution_list : список выполнений для рабочего процесса

  • execution_stop : Остановка запущенного выполнения

Ресурсы

Сервер предоставляет следующие ресурсы:

  • n8n://workflows/list : Список всех рабочих процессов

  • n8n://workflow/{id} : Подробности конкретного рабочего процесса

  • n8n://executions/{workflowId} : Список выполнений рабочего процесса

  • n8n://execution/{id} : Подробности конкретного исполнения

Разработка

Здание

npm run build

Работа в режиме разработки

npm run dev

Тестирование

npm test

Линтинг

npm run lint

Лицензия

Массачусетский технологический институт

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers