n8n Workflow MCP Server

Un servidor para validar y gestionar flujos de trabajo de n8n, con soporte multilingüe y múltiples modos operativos.

GitHub
17
Prueba este MCPPatrocinado

Documentación

n8n Workflow MCP Server

한국어 | English | 日本語 | Tiếng Việt | 繁體中文 | ไทย

🎬 Vídeo de demostración

Mira el video que demuestra la funcionalidad de búsqueda de workflows:

Servidor MCP (Model Context Protocol) para la validación y gestión de workflows de n8n.

🚀 Funciones principales

🌍 Soporte multilingüe

  • Coreano (ko) - Idioma predeterminado
  • Inglés (en) - English support
  • Japonés (jp) - 日本語サポート
  • Vietnamita (vn) - Hỗ trợ tiếng Việt
  • Taiwanés (tw) - 繁體中文支援
  • Tailandés (th) - การสนับสนุนภาษาไทย
  • Todas las descripciones de herramientas y parámetros se muestran en el idioma seleccionado

📝 Herramientas de gestión de workflows

  • ping - Verifica el estado de la conexión del servidor
  • validate_workflow - Valida la sintaxis de workflows de n8n en archivos JSON

🔍 Herramientas de búsqueda

  • search_n8n_nodes - Busca nodos de n8n por palabra clave
  • search_workflow - Busca plantillas de workflows de n8n de la comunidad

🛠 Instalación y compilación

Requisitos previos

  • Go 1.23 o superior

Método de compilación

🚀 Modo Standalone (recomendado)

Incluye todos los datos de nodos de n8n en el binario al compilar, permitiendo ejecutarlo sin archivos externos:

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

Compilación para plataformas específicas

macOS (Intel):

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

macOS (Apple Silicon M1/M2):

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

🎯 Métodos de ejecución

🚀 Modo Standalone (recomendado)

Ejecución solo con el binario, sin archivos externos (modo predeterminado):

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

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

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

📁 Modo sistema de archivos (para desarrollo)

Método que utiliza archivos de datos externos:

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

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

Ejecución directa con el comando Go

# Standalone 모드 (기본)
go run ./cmd/n8n-mcp-server -standalone

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

🌐 Soporte multilingüe

El servidor admite coreano (ko), inglés (en), japonés (jp), vietnamita (vn), taiwanés (tw) y tailandés (th). Puedes configurar el idioma con la bandera --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  # 태국어

⚙️ Ajuste de pesos de búsqueda

Puedes ajustar los pesos de cada elemento en la búsqueda de nodos:

# 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

🆘 Otras opciones

# 도움말 보기
./build/n8n-mcp-server --help

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

🔧 Configuración de Claude Code y Cursor

Configuración en macOS

Ubicación del archivo de configuración: ~/Library/Application Support/Claude/claude_desktop_config.json

Modo Standalone (recomendado):

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

Modo sistema de archivos (para desarrollo):

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

Modo de ejecución con Go (para desarrollo):

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

Configuración en Windows

Ubicación del archivo de configuración: %APPDATA%\Claude\claude_desktop_config.json

Modo Standalone (recomendado):

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

Modo sistema de archivos (para desarrollo):

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

Modo de ejecución con Go (para desarrollo):

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

📁 Estructura del proyecto

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/                        # 빌드 결과물

🧪 Pruebas

# 모든 테스트 실행
make test

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

🛠 Desarrollo

# 코드 포맷팅
make fmt

# 린팅
make lint

# 모듈 정리
make mod-tidy

# 빌드 파일 정리
make clean

📊 Comparación de modos

FunciónModo StandaloneModo sistema de archivos
Facilidad de implementación✅ Binario único❌ Requiere archivos adicionales
Velocidad de ejecución✅ Rápida✅ Rápida
Uso de memoria⚠️ Ligeramente mayor✅ Bajo
Facilidad de desarrollo⚠️ Requiere recompilación✅ Reflejo en tiempo real
Entorno de producción✅ Recomendado❌ No recomendado
Entorno de desarrollo✅ Disponible✅ Recomendado

🔗 Enlaces relacionados