de en es ja ko ru zh

n8n-workflow-builder-mcp

Name: n8n-workflow-builder-mcp
Author: ifmelate

by ifmelate

Overview Schema Related Servers Score Discussions

JavaScript

Local

n8n Workflow Builder MCP

n8n 워크플로우를 구축하고 조작하기 위한 MCP(Model Context Protocol) 서버입니다. AI에게 프롬프트를 입력하는 것만으로 n8n 워크플로우를 구축하세요. Claude Code, VS Code, Cursor 및 모든 MCP 호환 클라이언트와 함께 작동합니다.

데모 영상:

영상 보기

Cursor 규칙

규칙 파일은 rules/n8n-mcp-server-rules.mdc에 있습니다.

Related MCP server: mcp-n8n-builder

주요 기능

워크플로우 관리: n8n 워크플로우를 프로그래밍 방식으로 생성, 업데이트 및 실행 (실행은 아직 구현되지 않음)
노드 탐색: 사용 가능한 n8n 노드와 해당 기능을 탐색
연결 관리: 워크플로우 노드 간의 연결 생성
AI 통합: 워크플로우 내 AI 구성 요소를 연결하기 위한 특수 도구
AI 친화적 인터페이스: AI 에이전트와의 상호 작용을 위해 특별히 설계됨
N8N 버전 관리: 자동 버전 감지 및 호환성 처리 - 184개 이상의 n8n 버전(1.86.0 – 2.6.2) 지원, 동적 노드 필터링 및 하위 호환성을 위한 "가장 가까운 하위 버전" 매칭 지원

사전 요구 사항

Node.js (v18 이상)
npm (npx 명령용)
MCP 호환 클라이언트 (Claude Code, VS Code, Cursor 등)

설치 및 설정

n8n API 키 얻기

브라우저에서 n8n 인스턴스를 엽니다.
Settings > API Keys로 이동합니다.
Create API Key를 클릭합니다.
생성된 키를 복사하여 구성에 사용합니다.

Claude Code (권장)

Claude Code CLI를 사용하여 MCP 서버를 추가합니다:

claude mcp add n8n-workflow-builder -- npx -y n8n-workflow-builder-mcp

그런 다음 환경 변수를 설정합니다:

claude mcp add n8n-workflow-builder \
  -e N8N_API_URL=http://localhost:5678 \
  -e N8N_API_KEY=your-n8n-api-key-here \
  -- npx -y n8n-workflow-builder-mcp

N8N_VERSION은 선택 사항입니다. 서버가 API에서 자동으로 감지합니다.

VS Code / Cursor

MCP 구성 파일에 추가합니다 (VS Code의 경우 .vscode/mcp.json, Cursor의 경우 .cursor/mcp.json):

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["-y", "n8n-workflow-builder-mcp"],
      "env": {
        "N8N_API_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-n8n-api-key-here"
      }
    }
  }
}

변경 사항을 적용하려면 IDE를 다시 시작하세요.

개발 설치

개발 또는 로컬 테스트를 위해 소스를 복제하고 빌드합니다:

git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git
cd n8n-workflow-builder-mcp
npm install
npm run build

그런 다음 MCP 클라이언트를 빌드된 진입점으로 지정합니다:

# Claude Code
claude mcp add n8n-workflow-builder -- node /absolute/path/to/n8n-workflow-builder-mcp/dist/index.js

# VS Code / Cursor — use the same JSON config above with "command": "node" and "args": ["/absolute/path/to/dist/index.js"]

자동 재빌드를 포함한 개발 환경:

npm run dev

사용 가능한 MCP 도구

서버는 n8n 워크플로우 작업을 위해 다음 도구를 제공합니다:

핵심 워크플로우 관리

도구 이름	설명	주요 매개변수
create_workflow	새 n8n 워크플로우 생성	`workflow_name`, `workspace_dir`
list_workflows	워크스페이스의 워크플로우 나열	`limit` (선택 사항), `cursor` (선택 사항)
get_workflow_details	특정 워크플로우에 대한 상세 정보 가져오기	`workflow_name`, `workflow_path` (선택 사항)
validate_workflow	노드 스키마 및 연결성에 대해 워크플로우 파일 검증	`workflow_name`, `workflow_path` (선택 사항)

노드 관리

도구 이름	설명	주요 매개변수
add_node	워크플로우에 새 노드 추가	`workflow_name`, `node_type`, `position` (선택 사항), `parameters` (선택 사항), `node_name` (선택 사항), `typeVersion` (선택 사항), `webhookId` (선택 사항), `workflow_path` (선택 사항), `connect_from` (선택 사항), `connect_to` (선택 사항)
edit_node	워크플로우의 기존 노드 편집	`workflow_name`, `node_id`, `node_type` (선택 사항), `node_name` (선택 사항), `position` (선택 사항), `parameters` (선택 사항), `typeVersion` (선택 사항), `webhookId` (선택 사항), `workflow_path` (선택 사항), `connect_from` (선택 사항), `connect_to` (선택 사항)
delete_node	워크플로우에서 노드 삭제	`workflow_name`, `node_id`, `workflow_path` (선택 사항)
list_available_nodes	선택적 필터링과 함께 사용 가능한 노드 유형 나열. 태그 스타일 동의어 및 다중 토큰 OR/AND 논리 지원	`search_term` (선택 사항), `n8n_version` (선택 사항), `limit` (선택 사항), `cursor` (선택 사항), `tags` (선택 사항, 기본값: true), `token_logic` (선택 사항: 'or' 기본값, 또는 'and')

연결 관리

도구 이름	설명	주요 매개변수
add_connection	두 노드 간의 연결 생성	`workflow_name`, `source_node_id`, `source_node_output_name`, `target_node_id`, `target_node_input_name`, `target_node_input_index` (선택 사항), `workflow_path` (선택 사항)
add_ai_connections	AI 모델, 도구 및 메모리를 에이전트에 연결	`workflow_name`, `agent_node_id`, `model_node_id` (선택 사항), `tool_node_ids` (선택 사항), `memory_node_id` (선택 사항), `embeddings_node_id` (선택 사항), `vector_store_node_id` (선택 사항), `vector_insert_node_id` (선택 사항), `vector_tool_node_id` (선택 사항), `workflow_path` (선택 사항)
connect_main_chain	AI 워크플로우 노드를 통해 최소한의 메인 경로 구축 (트리거 → 모델 → 메모리 → 임베딩 → 문서 로더 → 벡터 저장소 → 벡터 도구 → 에이전트)	`workflow_name`, `workflow_path` (선택 사항), `dry_run` (선택 사항), `idempotency_key` (선택 사항)

워크플로우 계획 및 구성

도구 이름	설명	주요 매개변수
plan_workflow	워크플로우를 업데이트하기 위한 비파괴적 계획(노드 및 연결) 생성. 파일에 쓰지 않음	`workflow_name`, `target` (노드, 연결), `workspace_dir` (선택 사항)
review_workflow_plan	계획을 메모리 내에서 적용하고 검증 오류, 경고 및 제안된 수정 사항 반환. 파일에 쓰지 않음	`workflow_name`, `plan`, `workflow_path` (선택 사항)
apply_workflow_plan	이전에 검토된 계획을 디스크의 워크플로우에 적용 (원자적 쓰기)	`workflow_name`, `plan`, `workflow_path` (선택 사항)
compose_ai_workflow	복잡한 AI 워크플로우(에이전트 + 모델 + 메모리 + 임베딩 + 벡터 + 도구 + 트리거)를 한 번의 호출로 구성 (연결 및 기본 검증 포함)	`workflow_name`, `plan`, `n8n_version` (선택 사항)

매개변수 관리

도구 이름	설명	주요 매개변수
suggest_node_params	기본값 및 필수 필드를 사용하여 노드 유형에 대한 최소한의 유효 매개변수 제안	`node_type`, `typeVersion` (선택 사항), `existing_parameters` (선택 사항)
list_missing_parameters	가시성 규칙을 고려하여 노드에 누락된 필수 매개변수 나열	`node_type`, `typeVersion` (선택 사항), `parameters`
fix_node_params	누락된 필수 필드에 기본값이 적용된 매개변수 반환	`node_type`, `typeVersion` (선택 사항), `parameters` (선택 사항)

템플릿 및 탐색

도구 이름	설명	주요 매개변수
list_template_examples	무료 템플릿에서 추출한 노드 사용 예시 나열. node_type 또는 template_name으로 필터링	`node_type` (선택 사항), `template_name` (선택 사항), `limit` (선택 사항), `cursor` (선택 사항)
get_n8n_version_info	현재 N8N 버전 및 기능 가져오기	`random_string`

검증 동작

validate_workflow는 경고를 오류로 승격시키며, 활성화된 노드가 추론된 startNode에서 시작하는 메인 체인에 (직접 또는 AI 포트를 통해) 연결되지 않은 경우 실패합니다. 연결성을 수정하려면 connect_from/connect_to 또는 add_ai_connections를 사용하세요.

문제 해결

일반

MCP 구성 확인 — JSON이 유효하고 서버 이름이 일치하는지 확인하세요.
Node.js 업데이트 — 최신 LTS 버전으로 업데이트하세요.
npm 캐시 지우기 — npx가 실패하는 경우: npm cache clean --force
전역 설치 시도 — 대체 방법: npm install -g n8n-workflow-builder-mcp

Claude Code

claude mcp list를 실행하여 서버가 등록되었는지 확인하세요.
claude mcp logs n8n-workflow-builder로 로그를 확인하세요.

VS Code / Cursor

출력 패널을 확인하세요 — 드롭다운에서 "MCP"를 선택하여 서버 로그를 확인합니다.
Settings > Features > MCP Servers에서 서버가 활성화되어 있는지 확인하세요.
구성 변경 후 IDE를 다시 시작하세요.

프로젝트 구조

/src: 메인 소스 코드
/src/tools: MCP 도구 구현
/src/models: 데이터 모델
/src/utils: 유틸리티 함수
/src/middleware: 인증 및 미들웨어
/config: 구성 파일
/tests: 테스트 파일
/workflow_nodes: n8n 노드 정의
/docs: 추가 문서

기여

기여를 환영합니다! 자유롭게 Pull Request를 제출해 주세요.

저장소 포크
기능 브랜치 생성 (git checkout -b feature/amazing-feature)
변경 사항 커밋 (git commit -m 'Add some amazing feature')
브랜치에 푸시 (git push origin feature/amazing-feature)
Pull Request 열기

라이선스

MIT 라이선스

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

4wRelease cycle

13Releases (12mo)

Issues opened vs closed

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Appeared in Searches

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ifmelate/n8n-workflow-builder-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server