n8n MCP-сервер

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

Обзор

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

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

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

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

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

Related MCP server: MCP Server for n8n Integration

Установка

Предпосылки

• 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

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

Генерация 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

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

Лицензия

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