n8n MCP Server
n8n MCP-сервер
Сервер протокола контекста модели (MCP), позволяющий помощникам на основе искусственного интеллекта взаимодействовать с рабочими процессами n8n посредством естественного языка.
Обзор
Этот сервер MCP предоставляет инструменты и ресурсы для помощников ИИ для управления рабочими процессами и выполнениями n8n. Он позволяет помощникам:
Перечисление, создание, обновление и удаление рабочих процессов
Активировать и деактивировать рабочие процессы
Выполнение рабочих процессов и мониторинг их статуса
Доступ к информации о рабочем процессе и статистике выполнения
Related MCP server: n8n MCP Server
Установка
Предпосылки
Node.js 18 или более поздняя версия
экземпляр n8n с включенным доступом API
Установить из npm
npm install -g n8n-mcp-serverУстановить из источника
# Clone the repository
git clone https://github.com/leonardsellem/n8n-mcp-server.git
cd n8n-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
# Optional: Install globally
npm install -g .Установка докера
Вы также можете запустить сервер с помощью Docker:
# Pull the image
docker pull leonardsellem/n8n-mcp-server
# Run the container with your n8n API configuration
docker run -e N8N_API_URL=http://your-n8n:5678/api/v1 \
-e N8N_API_KEY=your_n8n_api_key \
-e N8N_WEBHOOK_USERNAME=username \
-e N8N_WEBHOOK_PASSWORD=password \
leonardsellem/n8n-mcp-serverКонфигурация
Создайте файл .env в каталоге, где вы будете запускать сервер, используя .env.example в качестве шаблона:
cp .env.example .envНастройте следующие переменные среды:
Переменная | Описание | Пример |
| Полный URL API n8n, включая |
|
| API-ключ для аутентификации с помощью n8n |
|
| Имя пользователя для аутентификации через веб-перехватчик (если используются веб-перехватчики) |
|
| Пароль для аутентификации через веб-перехватчик |
|
| Включить ведение журнала отладки (необязательно) |
|
Генерация API-ключа n8n
Откройте ваш экземпляр n8n в браузере.
Перейдите в Настройки > API > Ключи API.
Создайте новый ключ API с соответствующими разрешениями.
Скопируйте ключ в ваш файл
.env
Использование
Запуск сервера
Из установочного каталога:
n8n-mcp-serverИли, если установлено глобально:
n8n-mcp-serverИнтеграция с помощниками на основе искусственного интеллекта
После сборки сервера ( npm run build ) вам нужно настроить вашего помощника AI (например, VS Code с расширением Claude или приложение Claude Desktop) для его запуска. Обычно это включает в себя редактирование файла конфигурации JSON.
Пример конфигурации (например, в VS Code settings.json или Claude Desktop claude_desktop_config.json ):
{
"mcpServers": {
// Give your server a unique name
"n8n-local": {
// Use 'node' to execute the built JavaScript file
"command": "node",
// Provide the *absolute path* to the built index.js file
"args": [
"/path/to/your/cloned/n8n-mcp-server/build/index.js"
// On Windows, use double backslashes:
// "C:\\path\\to\\your\\cloned\\n8n-mcp-server\\build\\index.js"
],
// Environment variables needed by the server
"env": {
"N8N_API_URL": "http://your-n8n-instance:5678/api/v1", // Replace with your n8n URL
"N8N_API_KEY": "YOUR_N8N_API_KEY", // Replace with your key
// Add webhook credentials only if you plan to use webhook tools
// "N8N_WEBHOOK_USERNAME": "your_webhook_user",
// "N8N_WEBHOOK_PASSWORD": "your_webhook_password"
},
// Ensure the server is enabled
"disabled": false,
// Default autoApprove settings
"autoApprove": []
}
// ... other servers might be configured here
}
}Ключевые моменты:
Замените
/path/to/your/cloned/n8n-mcp-server/на фактический абсолютный путь, по которому вы клонировали и построили репозиторий.Используйте правильный разделитель пути для вашей операционной системы (прямую косую черту
/для macOS/Linux, двойную обратную косую черту\\для Windows).Убедитесь, что вы указали правильный
N8N_API_URL(включая/api/v1) иN8N_API_KEY.Сервер необходимо собрать (
npm run build), прежде чем помощник сможет запустить файлbuild/index.js.
Доступные инструменты
Сервер предоставляет следующие инструменты:
Использование веб-хуков
Этот сервер MCP поддерживает выполнение рабочих процессов через веб-перехватчики n8n. Чтобы использовать эту функциональность:
Создайте рабочий процесс, запускаемый с помощью веб-перехватчика, в n8n.
Настройте базовую аутентификацию на узле вебхука.
Используйте инструмент
run_webhookдля запуска рабочего процесса, передав только имя рабочего процесса.
Пример:
const result = await useRunWebhook({
workflowName: "hello-world", // Will call <n8n-url>/webhook/hello-world
data: {
prompt: "Hello from AI assistant!"
}
});Аутентификация webhook выполняется автоматически с использованием переменных среды N8N_WEBHOOK_USERNAME и N8N_WEBHOOK_PASSWORD .
Управление рабочим процессом
workflow_list: Список всех рабочих процессовworkflow_get: Получить сведения о конкретном рабочем процессеworkflow_create: Создать новый рабочий процессworkflow_update: обновить существующий рабочий процессworkflow_delete: Удалить рабочий процессworkflow_activate: Активировать рабочий процессworkflow_deactivate: Деактивировать рабочий процесс
Управление исполнением
execution_run: выполнение рабочего процесса через APIrun_webhook: выполнение рабочего процесса через веб-хукexecution_get: Получить сведения о конкретном исполненииexecution_list: список выполнений для рабочего процессаexecution_stop: Остановка запущенного выполнения
Ресурсы
Сервер предоставляет следующие ресурсы:
n8n://workflows/list: Список всех рабочих процессовn8n://workflow/{id}: Подробности конкретного рабочего процессаn8n://executions/{workflowId}: Список выполнений рабочего процессаn8n://execution/{id}: Подробности конкретного исполнения
Разработка
Здание
npm run buildРабота в режиме разработки
npm run devТестирование
npm testЛинтинг
npm run lintЛицензия
Массачусетский технологический институт
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Open-source Zapier/n8n alternative as an MCP server: agents build, run and debug your workflows.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceA Model Context Protocol server that enables AI agents to interact with n8n workflows and automation tools through a standardized interface, allowing execution of workflows and access to n8n functions.-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that allows AI agents to interact with n8n workflows through natural language, enabling workflow management and execution via SSE connections.7MIT
- AlicenseAqualityAmaintenanceA Model Context Protocol server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations for effective workflow automation.2947,555 npm23,286MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations, enabling them to understand and work with n8n's 525+ workflow automation nodes.32MIT