n8n-mcp-server: n8n 워크플로우와 상호 작용하기 위한 MCP 서비스 도구

일반 소개

n8n-mcp-server는 GitHub에서 호스팅되는 오픈 소스 프로젝트로 Leonard Sellem이 개발했습니다. 이 도구는 n8n 워크플로우와 상호 작용하도록 특별히 설계된 MCP(모델 컨텍스트 프로토콜) 서비스 도구입니다. n8n은 자동화된 워크플로 플랫폼이며, 이 도구는 이러한 목적으로 MCP AI 어시스턴트가 n8n으로 직접 작동할 수 있도록 하는 프로토콜로, n8n 워크플로를 생성, 실행, 관리하는 데 사용할 수 있습니다. 개발자나 팀과 같이 AI로 자동화 작업을 간소화하려는 사람들을 위한 것입니다. 이 프로젝트는 2025년 3월에 업데이트가 예정되어 있어 유지 관리가 잘 되고 있습니다.

기능 목록

MCP 프로토콜을 통해 n8n을 연결하여 AI 어시스턴트가 워크플로우를 직접 제어할 수 있도록 하세요.
n8n 워크플로 생성 및 수정 지원.
n8n 워크플로우를 실행하고 결과를 확인할 수 있습니다.
환경 변수를 사용하여 n8n 연결 정보를 구성합니다.
오픈 소스 디자인, 코드를 자유롭게 조정할 수 있습니다.

도움말 사용

설치 단계

n8n-mcp-server를 사용하려면 먼저 설치해야 합니다. 정확한 단계는 다음과 같습니다:

준비 도구
컴퓨터에 Node.js가 설치되어 있는지 확인합니다(버전 18 이상 권장). 또한 API 기능이 켜져 있는 n8n 인스턴스가 실행 중이어야 합니다. n8n 설정으로 이동하여 API 키를 찾습니다.
프로젝트 다운로드
터미널에 입력합니다:

git clone https://github.com/leonardsellem/n8n-mcp-server.git

그런 다음 카탈로그로 이동합니다:

cd n8n-mcp-server

종속성 설치
이 명령을 실행합니다:

npm install

프로젝트에 필요한 파일을 로드합니다.

환경 변수 설정
예제 파일을 복사합니다:

cp .env.example .env

쇼(티켓) .env 파일에 예를 들어 n8n에 대한 정보를 입력합니다:

N8N_API_URL=http://localhost:5678/api/v1
N8N_API_KEY=你的n8n密钥
DEBUG=false

N8N_API_URL 은 n8n의 주소입니다.
N8N_API_KEY 이것이 핵심입니다.
DEBUG 로 설정 true 더 많은 로그를 볼 수 있습니다.

코드 컴파일
입력:

npm run build

이렇게 하면 코드가 실행 가능한 파일로 바뀝니다.

서비스 시작
실행 중입니다:

npm start

서비스가 시작되고 AI 어시스턴트가 표준 입력 및 출력을 통해 통신할 수 있습니다.

핵심 기능 사용 방법

설치가 완료되면 n8n-mcp-server는 MCP 서비스가 됩니다. 주요 역할은 AI가 n8n 워크플로와 상호 작용할 수 있도록 하는 것입니다. 방법은 다음과 같습니다:

AI에 연결
이 서비스를 AI 플랫폼에 추가해야 합니다. 예를 들어 MCP를 지원하는 도구에서 구성 파일을 편집하여 추가합니다:

{
"mcpServers": {
"n8n": {
"command": "n8n-mcp-server",
"env": {
"N8N_API_URL": "你的n8n地址",
"N8N_API_KEY": "你的密钥"
}
}
}
}

저장되면 AI가 이 서비스를 찾을 수 있습니다.

워크플로 만들기
AI에게 "나를 위해 n8n에서 워크플로를 만들어 매일 이메일로 보내줘"라고 말할 수 있습니다. 그러면 AI가 MCP 서비스를 통해 n8n에 요청을 전송하여 자동으로 생성합니다.
워크플로 실행
"내 메일 워크플로우 실행"이라고 말합니다. 이 서비스는 n8n에게 작업을 수행하도록 지시한 다음 "작업 완료" 또는 "문제가 발생했습니다"와 같은 결과를 반환합니다.
상태 확인
"내 워크플로가 어떻게 실행되고 있나요?"라고 질문하세요. 서비스가 n8n의 상태를 확인하여 정확하게 알려줍니다.
문제 디버깅
제대로 작동하지 않으면 .env 내부 DEBUG 적응(스토리를 다른 매체로 변환) true를 클릭하고 서비스를 다시 시작하면 자세한 로그를 확인할 수 있습니다. 개발자는 코드를 변경하여 기능을 추가할 수도 있습니다.

팁

n8n 로컬에서 실행하는 경우 주소는 일반적으로 다음과 같습니다. http://localhost:5678/api/v1.
키는 아무에게도 보여주지 말고 비밀로 유지하세요.
도커와 동일한 방식으로 n8n을 실행할 수 있습니다. .env 거의 그렇죠.

애플리케이션 시나리오

시간 제한 작업
매일 날씨를 확인하고 문자 알림을 보내는 워크플로로 사용할 수 있으며, AI가 서비스를 통해 직접 처리합니다.
데이터 처리
회사에서는 영업 데이터를 자동으로 정리하고 그룹에 보낼 양식을 생성하는 데 사용할 수 있습니다. AI 운영으로 시간과 노력을 절약할 수 있습니다.
테스트 개발
개발자는 이를 사용하여 AI와 n8n이 함께 작동하는 방식을 테스트하고 코드를 변경하여 새로운 아이디어를 시도할 수 있습니다.

QA

프로그래밍을 할 수 있어야 하나요?
방법을 몰라도 괜찮습니다. 명령줄에서 로드하는 방법만 알면 충분합니다. 하지만 함수를 변경하려면 JavaScript를 알아야 합니다.
이 서비스의 특별한 점은 무엇인가요?
이를 통해 사용자가 수동으로 탭할 필요 없이 AI가 n8n 워크플로우를 직접 관리할 수 있습니다.
몇 개의 N8N을 연결할 수 있나요?
원하는 수만큼. 각 서비스에 n8n 주소를 할당하고 여러 인스턴스를 실행하기만 하면 됩니다.