n8n-workflow-builder-mcp

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 или новее)
• npm или пряжа
• Компилятор 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 не отображается в курсоре

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

• Файл .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