n8n Workflow MCP Server

A server for validating and managing n8n workflows, featuring multilingual support and multiple operational modes.

n8n 워크플로우 검증 및 관리를 위한 MCP (Model Context Protocol) 서버입니다.

- 한국어 (ko)- 기본 언어
- 영어 (en)- English support
- 일본어 (jp)- 日本語サポート
- 베트남어 (vn)- Hỗ trợ tiếng Việt
- 대만어 (tw)- 繁體中文支援
- 태국어 (th)- การสนับสนุนภาษาไทย
- 모든 도구 설명과 파라미터 설명이 선택한 언어로 표시됩니다

- ping- 서버 연결 상태 확인
- validate_workflow- JSON 파일의 n8n 워크플로우 문법 검증

- search_n8n_nodes- 키워드로 n8n 노드 검색
- search_workflow- 커뮤니티 n8n 워크플로우 템플릿 검색

빌드 시점에 모든 n8n 노드 데이터를 바이너리에 포함하여 외부 파일 없이 실행 가능:

# 현재 플랫폼용 standalone 빌드 make build-standalone # 또는 make build # Linux 64bit standalone 빌드 make build-standalone-linux # 또는 make build-linux # Windows 64bit standalone 빌드 make build-standalone-windows # 또는 make build-windows

CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o build/n8n-mcp-server-darwin ./cmd/n8n-mcp-server

CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o build/n8n-mcp-server-darwin-arm64 ./cmd/n8n-mcp-server

# macOS/Linux ./build/n8n-mcp-server -standalone # Windows build\n8n-mcp-server.exe -standalone # Makefile 사용 make run # 또는 make run-standalone

# macOS/Linux ./build/n8n-mcp-server -standalone=false # Windows build\n8n-mcp-server.exe -standalone=false

# Standalone 모드 (기본) go run ./cmd/n8n-mcp-server -standalone # 파일 시스템 모드 go run ./cmd/n8n-mcp-server -standalone=false

서버는 한국어(ko), 영어(en), 일본어(jp), 베트남어(vn), 대만어(tw), 태국어(th)를 지원합니다.--lang플래그로 언어를 설정할 수 있습니다:

# Standalone 모드 ./build/n8n-mcp-server -standalone --lang ko # 한국어 (기본값) ./build/n8n-mcp-server -standalone --lang en # 영어 ./build/n8n-mcp-server -standalone --lang jp # 일본어 ./build/n8n-mcp-server -standalone --lang vn # 베트남어 ./build/n8n-mcp-server -standalone --lang tw # 대만어 ./build/n8n-mcp-server -standalone --lang th # 태국어 # 파일 시스템 모드 ./build/n8n-mcp-server -standalone=false --lang ko # 한국어 (기본값) ./build/n8n-mcp-server -standalone=false --lang en # 영어 ./build/n8n-mcp-server -standalone=false --lang jp # 일본어 ./build/n8n-mcp-server -standalone=false --lang vn # 베트남어 ./build/n8n-mcp-server -standalone=false --lang tw # 대만어 ./build/n8n-mcp-server -standalone=false --lang th # 태국어

# Standalone 모드에서 검색 가중치 조정 ./build/n8n-mcp-server -standalone \ --name-weight 3.0 \ --overview-weight 2.0 \ --case-weight 1.5 \ --op-weight 1.0 # 파일 시스템 모드에서 검색 가중치 조정 및 데이터 경로 변경 ./build/n8n-mcp-server -standalone=false \ --name-weight 3.0 \ --overview-weight 2.0 \ --case-weight 1.5 \ --op-weight 1.0 \ --data-path /custom/path/to/nodes

# 도움말 보기 ./build/n8n-mcp-server --help # 버전 확인 ./build/n8n-mcp-server --version

설정 파일 위치:~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "n8n-kor-workflow": { "command": "/Users/{username}/{clone_path}/build/n8n-mcp-server", "args": ["--standalone", "--lang", "ko"] } } }

{ "mcpServers": { "n8n-kor-workflow": { "command": "/Users/{username}/{clone_path}/build/n8n-mcp-server", "args": ["-standalone=false", "--lang", "ko"] } } }

{ "mcpServers": { "n8n-kor-workflow": { "command": "go", "args": ["run", "./cmd/n8n-mcp-server", "--standalone", "--lang", "ko"], "cwd": "/Users/{username}/{clone_path}" } } }

설정 파일 위치:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "n8n-kor-workflow": { "command": "C:\\path\\to\\n8n-workflow-mcp\\build\\n8n-mcp-server.exe", "args": ["--standalone", "--lang", "ko"] } } }

{ "mcpServers": { "n8n-kor-workflow": { "command": "C:\\path\\to\\n8n-workflow-mcp\\build\\n8n-mcp-server.exe", "args": ["-standalone=false", "--lang", "ko"] } } }

{ "mcpServers": { "n8n-kor-workflow": { "command": "go", "args": ["run", ".\\cmd\\n8n-mcp-server", "--standalone", "--lang", "ko"], "cwd": "C:\\path\\to\\n8n-workflow-mcp" } } }

n8n-workflow-mcp/ ├── cmd/ │ └── n8n-mcp-server/ # 메인 애플리케이션 엔트리포인트 ├── internal/ │ ├── config/ # 설정 관리 │ ├── handlers/ # MCP 요청 핸들러 │ ├── i18n/ # 다국어 지원 │ ├── search/ # 검색 엔진 │ ├── server/ # MCP 서버 구현 │ ├── services/ # 비즈니스 로직 │ ├── store/ # 데이터 저장소 │ ├── validator/ # 워크플로우 검증 │ └── workflow/ # 워크플로우 관리 ├── pkg/ │ └── types/ # 공통 타입 정의 ├── examples/ │ └── config/ # Claude Code & Cursor 설정 예제 ├── test/ # 테스트 파일 └── build/ # 빌드 결과물

# 모든 테스트 실행 make test # 커버리지와 함께 테스트 실행 make test-coverage

# 코드 포맷팅 make fmt # 린팅 make lint # 모듈 정리 make mod-tidy # 빌드 파일 정리 make clean

- n8n 공식 문서
- MCP (Model Context Protocol)
- Claude Code
- Cursor

Automated document processing and extraction