n8n MCP-сервер

Name: n8n MCP Server
Author: leonardsellem

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

Обзор

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

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

Related MCP server: MCP Toolkit

Установка

Предпосылки

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

{ "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