n8n Workflow Builder MCP Server

n8n Workflow Builder MCP-сервер

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

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

Требования

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

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

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

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

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

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

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

Эта команда загрузит и установит все необходимые пакеты, как определено в файле 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 :

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

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

На сервере определены следующие инструменты, доступ к которым можно получить через клиент 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.