AI 보조자가 자연어를 통해 n8n 워크플로우와 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

개요

이 프로젝트는 AI 비서가 인기 있는 워크플로우 자동화 도구인 n8n과 원활하게 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 이 서비스는 다리 역할을 하여 AI 비서가 자연어 명령어를 사용해 n8n 워크플로우와 실행을 프로그래밍적으로 관리하고 제어할 수 있도록 합니다.

설치

전제 조건

• Node.js 20세 이상
• API 접근 권한이 활성화된 n8n 인스턴스

npm에서 설치

소스 설치

도커 설치

Docker를 사용해 서버를 실행할 수도 있습니다:

서버 업데이트 중

서버를 어떻게 업데이트할지는 처음 설치한 방식에 따라 달라집니다.

1. npm을 통해 전역적으로 설치됨

서버를 npm install -g @leonardsellem/n8n-mcp-server로 설치했다면:

1. 터미널이나 명령 프롬프트를 엽니다.

2. 최신 버전을 얻기 위해 다음 명령을 실행하세요:

3. 서버가 현재 실행 중(예: 백그라운드 프로세스나 서비스)일 경우, 변경 사항이 적용되려면 서버를 재시작해야 합니다.

2. 소스에서 설치

저장소를 복제하고 소스에서 설치했다면:

n8n MCP Server

A Model Context Protocol (MCP) server that allows AI assistants to interact with n8n workflows through natural language.

Overview

This project provides a Model Context Protocol (MCP) server that empowers AI assistants to seamlessly interact with n8n, a popular workflow automation tool. It acts as a bridge, enabling AI assistants to programmatically manage and control n8n workflows and executions using natural language commands.

Installation

Prerequisites

• Node.js 20 or later
• n8n instance with API access enabled

Install from npm

npm install -g @leonardsellem/n8n-mcp-server

Install from source

# 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 Installation

You can also run the server using 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

Updating the Server

How you update the server depends on how you initially installed it.

1. Installed globally via npm

If you installed the server using npm install -g @leonardsellem/n8n-mcp-server:

1. Open your terminal or command prompt.
2. Run the following command to get the latest version:

   npm install -g @leonardsellem/n8n-mcp-server@latest
   

3. If the server is currently running (e.g., as a background process or service), you’ll need to restart it for the changes to take effect.

2. Installed from source

If you cloned the repository and installed from source:

1. Open your terminal or command prompt.
2. Navigate to the directory where you cloned the project:

   cd path/to/n8n-mcp-server
   

3. If you’ve made any local changes to the code that you want to keep, consider stashing them (optional):

   git stash
   

   You can apply them later with git stash pop.
4. Pull the latest changes from the repository (assuming you are on the main branch):

   git pull origin main
   

   If you are on a different branch, replace main with your branch name.
5. Install or update any changed dependencies:

   npm install
   

6. Rebuild the project to include the latest updates:

   npm run build
   

7. If you previously installed it globally from this source folder using npm install -g ., you might want to run this command again to update the global link:

   npm install -g .
   

8. Restart the server.