https://github.com/czlonkowski/n8n-mcp
https://www.n8n-mcp.com/

Установка в один клик

cd ~
wget "https://dokuwiki.nanokey.tech/_media/vm:n8n_mcp:install-n8n-mcp.tar" -O install-n8n-mcp.tar
tar -xvf install-n8n-mcp.tar
chmod +x install-n8n-mcp.sh
./install-n8n-mcp.sh

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

cd ~
wget "https://dokuwiki.nanokey.tech/_media/vm:n8n_mcp:install-n8n-mcp.tar" -O install-n8n-mcp.tar
tar -xvf install-n8n-mcp.tar
chmod +x install-n8n-mcp.sh
./install-n8n-mcp.sh

• Описание
• Системные требования
• Что делает скрипт
• Процесс установки
• Управление сервером
• Структура файлов
• Конфигурация
• Безопасность
• Мониторинг и логи
• Устранение неполадок
• FAQ

n8n MCP Docker Installer - это автоматизированный bash-скрипт для развертывания n8n-mcp сервера в Docker контейнере. Скрипт полностью автоматизирует процесс установки и настройки, создавая готовую к работе среду для многопользовательского доступа через HTTP режим.

Ключевые особенности:

• 🚀 Полная автоматизация - установка одной командой
• 🐳 Docker-based - изолированная среда выполнения
• 🔒 Безопасность - генерация уникальных токенов авторизации
• 👥 Многопользовательский режим - поддержка HTTP для нескольких клиентов
• 🎛️ Удобное управление - интерактивная консоль управления
• 🔧 Права пользователя - работа без root привилегий
• 🌍 Сетевой доступ - автоматическое определение IP адреса

• Ubuntu 18.04+
• Debian 10+
• Linux Mint 19+
• Другие Debian-based дистрибутивы

• RAM: 1 GB (рекомендуется 2 GB)
• Свободное место: 2 GB
• Права: sudo доступ
• Порты: 3000 (должен быть свободен)

Скрипт автоматически устанавливает:

• Docker Engine
• Docker Compose
• curl
• необходимые системные пакеты

• Проверяет права sudo
• Обновляет системные пакеты
• Устанавливает зависимости

• Добавляет официальный репозиторий Docker
• Устанавливает Docker Engine и Docker Compose
• Настраивает автозапуск Docker
• Добавляет пользователя в группу docker

/opt/n8nmcp/
├── docker-compose.yml    # Конфигурация контейнера
├── .env                 # Переменные окружения
├── data/                # Данные приложения
├── logs/                # Логи
├── config/              # Конфигурация
├── start.sh             # Запуск сервера
├── stop.sh              # Остановка сервера
├── status.sh            # Проверка статуса
├── update.sh            # Обновление образа
├── fix-permissions.sh   # Исправление прав
└── manage.sh            # Консоль управления

• Создает docker-compose.yml с оптимальными настройками
• Генерирует уникальный AUTH_TOKEN
• Настраивает переменные окружения
• Определяет IP адрес машины

• manage.sh - интерактивная консоль с 11 функциями
• start.sh/stop.sh - быстрый запуск/остановка
• status.sh - мониторинг состояния
• update.sh - обновление образа

• Создает systemd service для автозапуска
• Настраивает зависимости от Docker

• Загружает Docker образ
• Запускает контейнер
• Выполняет health check
• Выводит информацию о подключении

cd ~
wget "https://dokuwiki.nanokey.tech/_media/vm:n8n_mcp:install-n8n-mcp.tar" -O install-n8n-mcp.tar
tar -xvf install-n8n-mcp.tar

chmod +x install-n8n-mcp.sh
./install-n8n-mcp.sh

1. ⏳ Проверка системы и прав
2. 📦 Установка Docker и зависимостей
3. 📁 Создание структуры директорий
4. ⚙️ Генерация конфигурации
5. 🔑 Создание AUTH_TOKEN
6. 🚀 Запуск сервера
7. ✅ Проверка работоспособности

Время установки: 5-15 минут (зависит от скорости интернета)

/opt/n8nmcp/manage.sh

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

• 🟢 Запустить сервер - запуск n8n-mcp
• 🔴 Остановить сервер - корректная остановка
• 🔄 Перезапустить сервер - перезапуск без даунтайма
• 📊 Показать статус - состояние контейнера и ресурсы
• 📋 Показать логи - просмотр логов в реальном времени
• 🔄 Обновить образ - обновление до последней версии
• 🏥 Health Check - проверка доступности сервиса
• 📡 Информация о подключении - URL и токены
• 🔧 Исправить права доступа - восстановление прав
• ⚙️ Редактировать конфигурацию - изменение настроек
• 🔑 Показать AUTH_TOKEN - просмотр токена авторизации

# Запуск
/opt/n8nmcp/start.sh
 
# Остановка  
/opt/n8nmcp/stop.sh
 
# Статус
/opt/n8nmcp/status.sh
 
# Обновление
/opt/n8nmcp/update.sh
 
# Логи
cd /opt/n8nmcp && docker-compose logs -f

# Включить автозапуск
sudo systemctl enable n8n-mcp
 
# Запуск через systemd
sudo systemctl start n8n-mcp
 
# Остановка через systemd
sudo systemctl stop n8n-mcp
 
# Статус
sudo systemctl status n8n-mcp

# Основные параметры в docker-compose.yml
ports:
  - "3000:3000"           # Порт сервиса
  
environment:
  - MCP_MODE=http         # HTTP режим
  - USE_FIXED_HTTP=true   # Фиксированный HTTP
  - LOG_LEVEL=info        # Уровень логирования
  - TZ=Europe/Moscow      # Временная зона

resources:
  limits:
    memory: 1G            # Лимит памяти
    cpus: '0.5'          # Лимит CPU

# Основные настройки
AUTH_TOKEN=<generated-token>     # Токен авторизации
USE_FIXED_HTTP=true             # HTTP режим
MCP_MODE=http                   # Режим работы
TZ=Europe/Moscow                # Временная зона
 
# Настройки пользователя
CURRENT_UID=1000                # UID пользователя
CURRENT_GID=1000                # GID группы
 
# n8n API (настраивается вручную)
# N8N_API_URL=https://your-n8n-instance.com
# N8N_API_KEY=your-n8n-api-key

Для подключения к вашему n8n инстансу отредактируйте .env файл:

nano /opt/n8nmcp/.env
 
# Добавьте или раскомментируйте:
N8N_API_URL=https://your-n8n-instance.com
N8N_API_KEY=your-n8n-api-key

• AUTH_TOKEN - уникальный токен для каждой установки
• Токен генерируется случайным образом (32 символа base64)
• Хранится только в .env файле с правами 600
• Требуется для всех MCP подключений

• Контейнер запускается от имени текущего пользователя
• Все файлы принадлежат пользователю, запустившему установку
• Системные права используются только для установки Docker
• .env файл защищен правами 600 (только владелец)

• Сервис слушает только порт 3000
• Используется изолированная Docker сеть
• Доступ возможен только с авторизационным токеном
• Health check endpoint открыт для мониторинга

<WRAP center round tip 60%> 📋 Безопасность:

• Сохраните AUTH_TOKEN в безопасном месте
• Не передавайте токен по незащищенным каналам
• Регулярно обновляйте Docker образ
• Используйте файрвол для ограничения доступа к порту 3000

</WRAP>

# Локальная проверка
curl http://localhost:3000/health
 
# Сетевая проверка  
curl http://YOUR_IP:3000/health
 
# Через manage.sh
/opt/n8nmcp/manage.sh  # выбрать пункт 7

# В реальном времени
cd /opt/n8nmcp && docker-compose logs -f
 
# Последние 50 строк
cd /opt/n8nmcp && docker-compose logs --tail=50
 
# Логи через manage.sh
/opt/n8nmcp/manage.sh  # выбрать пункт 5

# Использование ресурсов контейнера
docker stats n8n-mcp-server
 
# Статус через manage.sh
/opt/n8nmcp/manage.sh  # выбрать пункт 4

После установки сервер доступен по адресам:

• Локально: http://localhost:3000
• Сеть: http://YOUR_IP:3000
• Health: http://localhost:3000/health

# Если появляется ошибка доступа к Docker
newgrp docker
 
# Или перелогиньтесь в систему
exit
# войдите снова

# Автоматическое исправление прав
/opt/n8nmcp/fix-permissions.sh
 
# Или вручную
sudo chown -R $(whoami):$(id -gn) /opt/n8nmcp/
chmod -R 755 /opt/n8nmcp/
chmod 600 /opt/n8nmcp/.env
chmod +x /opt/n8nmcp/*.sh

# Проверить логи запуска
cd /opt/n8nmcp && docker-compose logs
 
# Пересоздать контейнер
cd /opt/n8nmcp && docker-compose down
cd /opt/n8nmcp && docker-compose up -d --force-recreate
 
# Проверить порт 3000
sudo netstat -tulpn | grep 3000

# Проверить файрвол
sudo ufw status
 
# Открыть порт если нужно
sudo ufw allow 3000
 
# Проверить IP адрес
ip route get 8.8.8.8 | head -1 | awk '{print $7}'

# Автоматическое обновление
/opt/n8nmcp/update.sh
 
# Или вручную
cd /opt/n8nmcp
docker-compose down
docker-compose pull
docker-compose up -d

Q: Можно ли изменить порт сервера?
A: Да, отредактируйте docker-compose.yml и измените «3000:3000» на «НОВЫЙ_ПОРТ:3000»

Q: Как получить AUTH_TOKEN?
A: Выполните `grep «AUTH_TOKEN=» /opt/n8nmcp/.env | cut -d'=' -f2` или используйте manage.sh (пункт 11)

Q: Можно ли запустить несколько экземпляров?
A: Да, но нужно изменить порты и директории для каждого экземпляра

Q: Как подключиться к серверу извне?
A: Используйте http://IP_СЕРВЕРА:3000 с вашим AUTH_TOKEN

Q: Где хранятся данные?
A: В /opt/n8nmcp/data/ - эта директория сохраняется при обновлениях

Q: Какая версия Docker требуется?
A: Скрипт устанавливает последнюю стабильную версию автоматически

Q: Можно ли изменить директорию установки?
A: Нет, скрипт использует фиксированную директорию /opt/n8nmcp

Q: Как сделать резервную копию?
A: Скопируйте директорию /opt/n8nmcp/, особенно папку data/

Q: Поддерживается ли SSL/HTTPS?
A: Базово - нет. Используйте reverse proxy (nginx) для SSL

Q: Можно ли запустить на ARM процессоре?
A: Зависит от доступности образа для ARM архитектуры

Q: Сколько памяти потребляет сервер?
A: Обычно 200-500 MB в зависимости от нагрузки

Q: Как увеличить лимиты ресурсов?
A: Отредактируйте deploy.resources.limits в docker-compose.yml

Q: Можно ли масштабировать horizontally?
A: Да, запустите несколько экземпляров на разных портах с load balancer

<WRAP center round info 60%> 📞 Поддержка: Если у вас возникли проблемы, не описанные в FAQ, обратитесь к документации n8n-mcp или сообщите об ошибке в репозитории проекта. </WRAP>

—

Версия документации: 1.1 Дата обновления: date Автор: n8n MCP Community