Skip to content

Release v0.1.0

Choose a tag to compare

@Mineru98 Mineru98 released this 16 Jun 16:26
· 16 commits to main since this release

🎉 n8n Workflow MCP Server v0.1.0

n8n 워크플로우 검증 및 관리를 위한 MCP (Model Context Protocol) 서버의 첫 번째 공식 릴리즈입니다!

✨ 주요 기능

🌍 다국어 지원

  • 한국어 (ko) - 기본 언어
  • 영어 (en) - English support
  • 일본어 (jp) - 日本語サポート
  • 모든 도구 설명과 파라미터 설명이 선택한 언어로 표시

🛠 MCP 도구

  • ping - 서버 연결 상태 확인
  • validate_workflow - n8n 워크플로우 JSON 파일 문법 검증 및 오류 진단
  • search_n8n_nodes - 키워드 기반 n8n 노드 검색 (점수 기반 랭킹)

🚀 실행 모드

  • Standalone 모드 (권장) - 모든 데이터가 바이너리에 포함된 단일 실행 파일
  • 파일 시스템 모드 (개발용) - 외부 데이터 파일을 사용하는 개발 친화적 모드

⚙️ 고급 기능

  • 검색 가중치 조정 - 노드 검색 시 이름, 개요, 사용 사례, 작업별 가중치 커스터마이징
  • 크로스 플랫폼 지원 - macOS (Intel/Apple Silicon), Linux, Windows
  • Claude Code & Cursor 와의 MCP 연동 - 간편한 설정으로 Claude와 연동

🏗 기술 스택

  • Go 1.23+ - 고성능 백엔드
  • MCP Protocol - Claude와의 원활한 통신
  • 임베디드 데이터 - 외부 의존성 없는 standalone 실행

📦 설치 방법

바이너리 다운로드

릴리즈 페이지에서 플랫폼별 바이너리를 다운로드하세요.

바이너리 실행 시 이슈(mac)

# 터미널에서 격리 속성 제거
xattr -d com.apple.quarantine /path/to/n8n-mcp-server-darwin-arm64

# 실행 권한 부여
chmod +x /path/to/n8n-mcp-server-darwin-arm64

소스에서 빌드

# Standalone 모드 빌드 (권장)
make build-standalone

# 특정 플랫폼용 빌드
make build-standalone-linux    # Linux
make build-standalone-windows  # Windows

🔧 Claude Code & Cursor 설정 예제

{
  "mcpServers": {
    "n8n-workflow": {
      "command": "/path/to/n8n-mcp-server",
      "args": ["--standalone", "--lang", "ko"]
    }
  }
}

🎯 사용 사례

  • n8n 워크플로우 JSON 파일의 문법 오류 검증
  • 특정 기능을 위한 n8n 노드 검색 및 추천
  • Claude를 통한 자연어 기반 워크플로우 관리

🔄 향후 계획

  • 워크플로우 자동 생성 기능
  • 더 많은 언어 지원
  • 고급 워크플로우 분석 도구
  • 성능 최적화

🙏 감사의 말

이 프로젝트를 사용해주시는 모든 분들께 감사드립니다. 버그 리포트나 기능 제안은 언제든 환영합니다!


전체 변경사항: https://github.com/n8nKOR/n8n-workflow-mcp/commits/v0.1.0