n8n Workflow Builder MCP-сервер

Этот проект предоставляет сервер MCP для управления рабочими процессами n8n. Он предлагает функциональность для перечисления, создания, обновления, удаления, активации и деактивации рабочих процессов с помощью набора определенных инструментов.

Важный:
Эта версия поддерживает исключительно npm для управления пакетами и запуска сервера. (поддержка npx будет повторно введена в будущем обновлении.)

Требования

• Node.js (рекомендуется v14+)

• нпм

Related MCP server: n8n MCP Server

Подробное руководство по установке

1. Клонировать репозиторий

Клонируйте репозиторий из предпочитаемого вами источника. Например:

git clone https://github.com/makafeli/n8n-workflow-builder.git

Затем перейдите в каталог проекта:

cd /root/n8n-workflow-builder

2. Установка зависимостей

Установите необходимые зависимости с помощью npm:

npm install

Эта команда загрузит и установит все необходимые пакеты, как определено в файле package.json .

3. Сборка и тестирование

Для тестирования и запуска сервера используйте следующие команды:

• Создайте проект:
  Это скомпилирует файлы TypeScript и создаст исполняемый JavaScript в каталоге build .

  npm run build

• Запустите MCP-сервер:
  Запустите сервер с помощью:

  npm start

Сервер запустится и подключится через stdio. Вы можете проверить консоль, чтобы увидеть сообщения, подтверждающие, что сервер запустился правильно.

4. Развертывание

Для тестирования и для запуска сервера в сети используйте команды сборки и запуска, упомянутые выше. Этот базовый рабочий процесс (установка, сборка, запуск) в настоящее время является рекомендуемым методом.

5. Дополнительная конфигурация

Конфигурация сервера для Cline управляется через файл cline_mcp_settings.json . Убедитесь, что следующие переменные среды установлены правильно:

• N8N_HOST : URL-адрес вашего хоста API n8n.

• N8N_API_KEY : Ваш ключ API n8n.

Пример конфигурации в cline_mcp_settings.json :

{
  "n8n-workflow-builder": {
    "command": "node",
    "args": ["/root/n8n-workflow-builder/build/index.js"],
    "env": {
      "N8N_HOST": "https://n8n.io/api/v1/",
      "N8N_API_KEY": "YOUR_N8N_API_KEY_HERE"
    },
    "disabled": false,
    "alwaysAllow": [
      "create_workflow",
      "create_workflow_and_activate",
      "update_workflow",
      "activate_workflow",
      "deactivate_workflow",
      "get_workflow",
      "delete_workflow"
    ],
    "autoApprove": []
  }
}

Доступные функции

Инструменты МКП

На сервере определены следующие инструменты, доступ к которым можно получить через клиент MCP:

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

• list_workflows : список всех рабочих процессов из n8n.

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

• get_workflow : извлекает рабочий процесс по его идентификатору.

• update_workflow : обновляет существующий рабочий процесс.

• delete_workflow : удаляет рабочий процесс по его идентификатору.

• activate_workflow : активирует рабочий процесс по его идентификатору.

• deactivate_workflow : деактивирует рабочий процесс по его идентификатору.

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

• list_executions : список всех выполнений рабочего процесса с дополнительными фильтрами.

• get_execution : извлекает сведения о конкретном выполнении по его идентификатору.

• delete_execution : Удаляет выполнение по его идентификатору.

Ресурсы МКП

Сервер также предоставляет следующие ресурсы для более эффективного контекстного доступа:

Статические ресурсы

• /workflows : Список всех доступных рабочих процессов в экземпляре n8n

• /execution-stats : Сводная статистика о выполнении рабочих процессов

Шаблоны динамических ресурсов

• /workflows/{id} : Подробная информация о конкретном рабочем процессе

• /executions/{id} : Подробная информация о конкретном исполнении

Поиск неисправностей

• Убедитесь, что вы используете npm (эта версия не поддерживает npx).

• Если у вас возникли какие-либо проблемы, попробуйте очистить каталог сборки и выполнить повторную сборку:

  npm run clean && npm run build

• Проверьте правильность переменных среды в cline_mcp_settings.json .

Будущие улучшения

• Повторное введение поддержки npx.

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

• Дальнейшие усовершенствования развертывания и масштабирования.

Лицензия

Данный проект лицензирован по лицензии MIT.