n8n-workflow-mcp

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #go #golang #android #deep-learning #docker #nodejs #java #awesome #kubernetes #ios #open-source

n8n-workflow-mcp

(★ 17)

이젠 n8n workflow도 vibe 하게🚀 n8n workflow assistant mcp server

n8n-workflow-mcp Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# n8n Workflow MCP Server

[![한국어](https://img.shields.io/badge/README-한국어-blue)](https://raw.githubusercontent.com/n8nKOR/n8n-workflow-mcp/main/README.md) | [![English](https://img.shields.io/badge/README-English-red)](https://raw.githubusercontent.com/n8nKOR/n8n-workflow-mcp/main/README.en.md) | [![日本語](https://img.shields.io/badge/README-日본語-green)](https://raw.githubusercontent.com/n8nKOR/n8n-workflow-mcp/main/README.jp.md) | [![Tiếng Việt](https://img.shields.io/badge/README-Tiếng%20Việt-yellow)](https://raw.githubusercontent.com/n8nKOR/n8n-workflow-mcp/main/README.vn.md) | [![繁體中文](https://img.shields.io/badge/README-繁體中文-purple)](https://raw.githubusercontent.com/n8nKOR/n8n-workflow-mcp/main/README.tw.md) | [![ไทย](https://img.shields.io/badge/README-ไทย-orange)](https://raw.githubusercontent.com/n8nKOR/n8n-workflow-mcp/main/README.th.md)

## 🎬 데모 비디오

워크플로우 검색 기능을 시연하는 비디오를 확인해보세요:

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 워크플로우 템플릿 검색

## 🛠 설치 및 빌드

### 필요 조건
- Go 1.23 이상

### 빌드 방법

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

```bash
# 현재 플랫폼용 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
```

#### 특정 플랫폼용 빌드

**macOS (Intel):**
```bash
CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o build/n8n-mcp-server-darwin ./cmd/n8n-mcp-server
```

**macOS (Apple Silicon M1/M2):**
```bash
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o build/n8n-mcp-server-darwin-arm64 ./cmd/n8n-mcp-server
```

## 🎯 실행 방법

### 🚀 Standalone 모드 (권장)
외부 파일 없이 바이너리만으로 실행 (기본 모드):

```bash
# macOS/Linux
./build/n8n-mcp-server -standalone

# Windows
build\n8n-mcp-server.exe -standalone

# Makefile 사용
make run
# 또는
make run-standalone
```

### 📁 파일 시스템 모드 (개발용)
외부 데이터 파일을 사용하는 방식:

```bash
# macOS/Linux
./build/n8n-mcp-server -standalone=false

# Windows
build\n8n-mcp-server.exe -standalone=false
```

### Go 명령어로 직접 실행
```bash
# Standalone 모드 (기본)
go run ./cmd/n8n-mcp-server -standalone

# 파일 시스템 모드
go run ./cmd/n8n-mcp-server -standalone=false
```

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

```bash
# 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  # 태국어
```

### ⚙️ 검색 가중치 조정
노드 검색 시 각 요소의 가중치를 조정할 수 있습니다:

```bash
# 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
```

### 🆘 기타 옵션
```bash
# 도움말 보기
./build/n8n-mcp-server --help

# 버전 확인
./build/n8n-mcp-server --version
```

## 🔧 Claude Code & Cursor 설정

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

**Standalone 모드 (권장):**
```json
{
  "mcpServers": {
    "n8n-kor-workflow": {
      "command": "/Users/{username}/{clone_path}/build/n8n-mcp-server",
      "args": ["--standalone", "--lang", "ko"]
    }
  }
}
```

**파일 시스템 모드 (개발용):**
```json
{
  "mcpServers": {
    "n8n-kor-workflow": {
      "command": "/Users/{username}/{clone_path}/build/n8n-mcp-server",
      "args": ["-standalone=false", "--lang", "ko"]
    }
  }
}
```

**Go 실행 모드 (개발용):**
```json
{
  "mcpServers": {
    "n8n-kor-workflow": {
      "command": "go",
      "args": ["run", "./cmd/n8n-mcp-server", "--standalone", "--lang", "ko"],
      "cwd": "/Users/{username}/{clone_path}"
    }
  }
}
```

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

**Standalone 모드 (권장):**
```json
{
  "mcpServers": {
    "n8n-kor-workflow": {
      "command": "C:\\path\\to\\n8n-workflow-mcp\\build\\n8n-mcp-server.exe",
      "args": ["--standalone", "--lang", "ko"]
    }
  }
}
```

**파일 시스템 모드 (개발용):**
```json
{
  "mcpServers": {
    "n8n-kor-workflow": {
      "command": "C:\\path\\to\\n8n-workflow-mcp\\build\\n8n-mcp-server.exe",
      "args": ["-standalone=false", "--lang", "ko"]
    }
  }
}
```

**Go 실행 모드 (개발용):**
```json
{
  "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/                        # 빌드 결과물
```

## 🧪 테스트

```bash
# 모든 테스트 실행
make test

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

## 🛠 개발

```bash
# 코드 포맷팅
make fmt

# 린팅
make lint

# 모듈 정리
make mod-tidy

# 빌드 파일 정리
make clean
```

## 📊 모드 비교

| 기능 | Standalone 모드 | 파일 시스템 모드 |
|------|-----------------|-------------------|
| **배포 편의성** | ✅ 단일 바이너리 | ❌ 추가 파일 필요 |
| **실행 속도** | ✅ 빠름 | ✅ 빠름 |
| **메모리 사용량** | ⚠️ 약간 높음 | ✅ 낮음 |
| **개발 편의성** | ⚠️ 리빌드 필요 | ✅ 실시간 반영 |
| **운영 환경** | ✅ 권장 | ❌ 비권장 |
| **개발 환경** | ✅ 사용 가능 | ✅ 권장 |

## 🔗 관련 링크

- [n8n 공식 문서](https://docs.n8n.io/)
- [MCP (Model Context Protocol)](https://github.com/mark3labs/mcp-go)
- [Claude Code](https://claude.ai/download)
- [Cursor](https://cursor.com)

n8n-workflow-mcp

n8n-workflow-mcp Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

n8n-workflow-mcp

n8n-workflow-mcp Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README