n8n Workflow Builder MCP

Этот проект предоставляет сервер Model Context Protocol (MCP) для построения и управления рабочими процессами n8n JSON в Cursor IDE. Это способ построения рабочих процессов n8n просто с помощью подсказок с помощью ИИ в чате.

ДЕМО ВИДЕО:

Текущий статус реализации

Находится на ранней стадии разработки. В принципе, работает - сервер MCP создает файл JSON с рабочим процессом n8n, который можно скопировать и вставить в редактор рабочего процесса в пользовательском интерфейсе n8n. Текущие проблемы:

• иногда агенты llm вставляют неправильные параметры в запрос. Я планирую найти способ исправить это .

• иногда соединение между узлами не устанавливается. Я работаю над решением этой проблемы .

• не все типы узлов проверены на работоспособность. Я работаю над решением этой проблемы .

• Первоначальная подсказка имеет значение. Если она не ясна, агент пойдет не туда. Я планирую найти способ исправить это .

Основные характеристики

• Управление рабочими процессами : создание, обновление и выполнение рабочих процессов n8n программным способом (функция выполнения пока не реализована)

• Обнаружение узлов : изучение доступных узлов n8n и их возможностей.

• Управление соединениями : создание соединений между узлами рабочего процесса.

• Интеграция ИИ : специальные инструменты для подключения компонентов ИИ в рабочих процессах

• Интерфейс, дружественный к ИИ : разработан специально для взаимодействия с агентами ИИ.

Предпосылки

• Node.js (v14 или выше)

• Курсор IDE (v0.48 или новее)

• нпм или пряжа

• Компилятор TypeScript (устанавливается как зависимость разработки через npm install )

Установка

1. Клонируйте репозиторий:

   git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git cd n8n-workflow-builder-mcp

2. Установить зависимости:

   npm install

3. Создайте проект TypeScript:

   npm run build

4. Сделайте скрипт сервера MCP исполняемым (при необходимости):

   chmod +x dist/index.js

Запуск сервера

Запустите MCP-сервер:

Это запустит скомпилированный код из dist/index.js .

Для разработки с автоматической пересборкой и перезапуском при внесении изменений:

Интеграция курсора IDE

Существует два способа настройки сервера MCP с помощью Cursor:

Метод 1: использование пользовательского интерфейса настроек курсора (рекомендуется)

1. Запустить курсор IDE

2. Перейдите в Настройки > Функции > Серверы MCP.

3. Нажмите «Добавить сервер» и укажите абсолютный путь к файлу dist/index.js (например, /Users/yourname/n8n-workflow-builder-mcp/dist/index.js )

4. Убедитесь, что сервер включен.

5. Перезапустите Cursor IDE, чтобы изменения вступили в силу.

Метод 2: Ручная настройка

1. Убедитесь, что каталог .cursor существует:

   mkdir -p .cursor

2. Создайте файл конфигурации MCP:

   cat > .cursor/mcp.json << 'EOF' { "mcpServers": { "n8n-workflow-builder": { "command": "node", "args": ["/absolute/path/to/n8n-workflow-builder-mcp/dist/index.js"] } } } EOF

   Обязательно замените /absolute/path/to на фактический путь в вашей системе.

3. Перезапустите Cursor IDE, чтобы изменения вступили в силу.

Доступные инструменты MCP

Сервер предоставляет следующие инструменты для работы с рабочими процессами n8n:

Устранение неполадок интеграции курсора

Если у вас возникли проблемы с работой сервера MCP с Cursor, попробуйте выполнить следующие действия:

1. Перезапустить курсор : после настройки конфигурации MCP полностью закройте и перезапустите курсор.

2. Проверьте настройки курсора MCP :

   • Открыть настройки курсора

   • Перейти к разделу «Функции» > «Серверы MCP»

   • Убедитесь, что ваш сервер указан и включен

   • Если он есть в списке, но не работает, попробуйте нажать кнопку «Обновить».

3. Проверьте журналы сервера : найдите ошибки в терминале, где запущен сервер, или на панели Cursor Output. Выберите «Cursor MCP» из раскрывающегося списка на панели Output, чтобы увидеть журналы, специфичные для MCP.

4. Проверьте права доступа к файлу : убедитесь, что файл dist/index.js имеет права на выполнение.

5. Проверьте наличие конфликтов портов : Если запущены другие серверы MCP, они могут конфликтовать. Проверьте наличие других процессов, использующих те же порты.

6. Попробуйте глобальную установку : вместо использования локального пути вы можете попробовать установить сервер глобально:

   npm install -g n8n-workflow-builder-mcp

   Затем обновите файл .cursor/mcp.json , чтобы использовать глобальную команду.

Распространенные проблемы и решения

«Не удалось создать клиента»

Обычно это происходит, когда:

• Сервер MCP не работает

• Возникла проблема с подключением между курсором и сервером.

• Сервер рухнул во время инициализации

Пытаться:

1. Запуск тестового скрипта для проверки корректной работы сервера.

2. Проверка ошибок в журналах сервера

3. Перезапуск курсора

MCP Server не отображается в курсоре

Это может произойти, если:

• Файл .cursor/mcp.json не отформатирован должным образом.

• Курсор не обнаружил изменение конфигурации

Пытаться:

1. Проверка формата JSON вашего файла .cursor/mcp.json

2. Перезапуск курсора

3. Выбор сервера вручную в настройках курсора (если он там отображается)

Сервер MCP отображается, но инструменты недоступны

Это может произойти, если:

• Сервер не регистрирует свои инструменты должным образом.

• Возникла проблема с запросом/ответом ListOfferings

Пытаться:

1. Запуск тестового скрипта для проверки правильности регистрации инструментов.

2. Нажатие кнопки обновления в настройках сервера MCP в Курсоре

3. Проверка журналов сервера на наличие ошибок

Структура проекта

• /src : Основной исходный код

• /src/tools : Реализация инструментов MCP

• /src/models : Модели данных

• /src/utils : Вспомогательные функции

• /src/middleware : Аутентификация и промежуточное ПО

• /config : Файлы конфигурации

• /tests : Тестовые файлы

• /workflow_nodes : определения узлов n8n

• /docs : Дополнительная документация

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

1. Форк репозитория

2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

4. Отправить в ветку ( git push origin feature/amazing-feature )

5. Открыть запрос на извлечение

Лицензия

Работаем по лицензии - необходимо подтверждение от команды n8n