개요

n8n-mcp는 AI 코딩 어시스턴트와 n8n 워크플로우 자동화 플랫폼을 연결하는 오픈소스 Model Context Protocol(MCP) 서버입니다. Claude Desktop, Claude Code, Cursor, Windsurf, VS Code 등의 도구에 n8n 전체 생태계에 대한 구조화된 실시간 지식을 제공합니다(537개의 코어 노드 + 547개의 커뮤니티 노드, 총 1,084개 노드, 2,709개의 워크플로우 템플릿, AI 전용 검증 로직 포함).

경량 Node.js 애플리케이션으로 구축되었으며 내장 SQLite 데이터베이스를 사용합니다. 응답 속도는 12ms 미만이며 stdio 또는 HTTP 모드로 작동합니다. 한 번 연결하면 AI가 복사-붙여넣기나 수동 설정 없이 완전한 n8n 워크플로우를 구축·검증·테스트·배포할 수 있습니다.

호스팅 버전(바로 사용할 수 있는 Chat Agent 포함)은 n8n-mcp.com에서 이용 가능하며(무료 플랜 + 유료 플랜), GitHub 저장소는 MIT 라이선스로 완전한 셀프 호스팅이 가능합니다.

주요 기능

포괄적인 노드 지식 베이스 — 1,084개 n8n 노드에 완전 액세스(속성 커버리지 99%, 작업 커버리지 63.6%, 공식 문서 커버리지 87%). n8n 신규 릴리스 후 48시간 이내 업데이트.
스마트 검색 및 발견 — search_nodes, get_node(여러 상세 모드), verified/community 기준 커뮤니티 노드 필터링.
실제 사용 예시 — 인기 템플릿에서 추출한 2,646개의 사전 추출 설정.
고급 검증 기능 — validate_node 및 validate_workflow. AI 에이전트 프로필, 런타임 검사, 의존성 분석 지원. n8n v2.17+ AI Agent 워크플로우 호환.
템플릿 엔진 — 2,709개 이상의 즉시 사용 가능한 워크플로우 JSON 검색 및 조회, 스마트 필터링 지원.
n8n 관리 도구(선택적 API 연결) — 기존 n8n 인스턴스에서 워크플로우 생성·업데이트·테스트·실행·자동 수정 가능.
성능 및 호환성 — 평균 응답 약 12ms, 메모리 사용량 70–120 MB. 모든 Node.js 버전 지원. stdio(Claude Desktop) 및 HTTP/SSE 모드 지원.
프라이버시 및 보안 — 선택적 익명 텔레메트리(쉽게 비활성화 가능), 하드코딩된 자격증명 없음, webhook 보안 모드 지원.

설치 및 설정

빠른 시작 (npx – 설치 불필요)

npx n8n-mcp

Claude Desktop의 claude_desktop_config.json에 추가하고 MCP_MODE=stdio로 설정하세요.

Docker (프로덕션 환경 추천)

docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest

클라우드 (원클릭 배포)

리포지토리 템플릿을 통해 Railway에 무료 배포 가능.

로컬 전체 빌드

git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build
npm run rebuild
npm start

선택적 환경 변수: N8N_API_URL, N8N_API_KEY(직접 워크플로우 관리용), LOG_LEVEL=error, MCP_MODE=stdio.

지원 AI 어시스턴트

Claude Desktop / Claude Code
Cursor
Windsurf
VS Code + Codex
Antigravity
기타 MCP 호환 클라이언트 (호스팅 서비스에서 20개 이상 도구 지원)

사용 사례

AI 주도 워크플로우 생성 — “Twitter 멘션을 모니터링하고 감정 분석이 포함된 요약을 Slack에 게시”라고 지시하면 AI가 완전한 JSON을 생성·검증·배포합니다.
기존 워크플로우 유지보수 — 라이브 워크플로우를 읽고 최적화를 제안한 후 대상 부분을 업데이트.
템플릿 탐색 — “커뮤니티 노드를 사용한 최고의 CRM 동기화 템플릿”을 물어보면 바로 임포트 가능한 JSON을 제공.
엔터프라이즈 자동화 — 셀프 호스팅 n8n 인스턴스에 연결하여 대규모·안전·감사 가능한 워크플로우 생성.
학습 및 프로토타이핑 — 검증 도구를 사용해 프로덕션 배포 전에 AI에게 모범 사례를 가르침.

n8n 내장 MCP와 n8n-mcp의 차이점

n8n의 네이티브 MCP 서버(최근 릴리스에서 제공)는 자신의 워크플로우를 도구로 노출합니다. 반면 n8n-mcp는 보완적인 외부 MCP 서버로, n8n 노드 지식과 AI 지원 워크플로우 작성에 특화되어 있습니다. 두 가지를 함께 사용하면 최대의 효과를 발휘합니다: 네이티브 서버로 워크플로우를 트리거하고, n8n-mcp로 지능형 워크플로우를 구축.

링크 및 리소스

GitHub: czlonkowski/n8n-mcp
호스팅 Chat Agent & 대시보드: n8n-mcp.com
무료 플랜: 호스팅版은 하루 100회 도구 호출, 셀프 호스팅은 무제한
문서와 예시는 저장소에 포함

n8n-mcp는 어떤 AI 코딩 어시스턴트든 즉시 풀스택 n8n 워크플로우 전문가로 만들어줍니다.

개요