n8n MCP-сервер

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

Обзор

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

Перечисление, создание, обновление и удаление рабочих процессов
Активировать и деактивировать рабочие процессы
Выполнение рабочих процессов и мониторинг их статуса
Доступ к информации о рабочем процессе и статистике выполнения

Установка

Предпосылки

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

Откройте ваш экземпляр n8n в браузере.
Перейдите в Настройки > API > Ключи API.
Создайте новый ключ API с соответствующими разрешениями.
Скопируйте ключ в ваш файл .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. Чтобы использовать эту функциональность:

Создайте рабочий процесс, запускаемый с помощью веб-перехватчика, в n8n.
Настройте базовую аутентификацию на узле вебхука.
Используйте инструмент 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

Лицензия

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

n8n MCP Server

Integrations