n8n-workflow-builder-mcp

n8n 워크플로 빌더 MCP

이 프로젝트는 Cursor IDE에서 n8n 워크플로 JSON을 빌드하고 조작할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 채팅에서 AI에게 요청하는 것만으로 n8n 워크플로를 구축할 수 있습니다.

데모 비디오:

현재 구현 현황

현재 초기 개발 단계입니다. 기본적으로는 정상적으로 작동합니다. MCP 서버가 n8n 워크플로를 사용하여 JSON 파일을 생성하고, 이 파일을 n8n UI의 워크플로 편집기에 복사하여 붙여넣을 수 있습니다. 현재 문제:

• 가끔 LLM 담당자가 요청에 잘못된 매개변수를 입력하는 경우가 있습니다. 이 문제를 해결할 방법을 찾을 예정입니다 .
• 가끔 노드 간 연결이 설정되지 않는 경우가 있습니다. 해결을 위해 노력 중입니다 .
• 모든 유형의 노드가 제대로 작동하는지 확인되지 않았습니다. 이 문제를 해결하기 위해 노력하고 있습니다 .
• 초기 프롬프트는 중요합니다. 명확하지 않으면 상담원이 잘못된 방향으로 갈 것입니다. 이 문제를 해결할 방법을 찾을 계획입니다 .

주요 특징

• 워크플로 관리 : n8n 워크플로를 프로그래밍 방식으로 생성, 업데이트 및 실행합니다(실행은 아직 구현되지 않음)
• 노드 검색 : 사용 가능한 n8n 노드와 해당 기능 탐색
• 연결 관리 : 워크플로 노드 간 연결 생성
• AI 통합 : 워크플로에서 AI 구성 요소를 연결하기 위한 특수 도구
• AI 친화적 인터페이스 : AI 에이전트와의 상호 작용을 위해 특별히 설계되었습니다.

필수 조건

• Node.js(v14 이상)
• 커서 IDE(v0.48 이상)
• npm 또는 yarn
• TypeScript 컴파일러( npm install 통해 개발 종속성으로 설치됨)

설치

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   npm install
3. TypeScript 프로젝트를 빌드합니다.
   npm run build
4. MCP 서버 스크립트를 실행 가능하게 만듭니다(필요한 경우):
   chmod +x dist/index.js

서버 실행

MCP 서버를 시작합니다.

이렇게 하면 dist/index.js 에서 컴파일된 코드가 실행됩니다.

변경 시 자동 재빌드 및 재시작을 사용하여 개발하는 경우:

커서 IDE 통합

커서를 사용하여 MCP 서버를 설정하는 방법은 두 가지가 있습니다.

방법 1: 커서 설정 UI 사용(권장)

1. 커서 IDE 시작
2. 설정 > 기능 > MCP 서버로 이동하세요.
3. "서버 추가"를 클릭하고 dist/index.js 파일의 절대 경로를 제공합니다(예: /Users/yourname/n8n-workflow-builder-mcp/dist/index.js ).
4. 서버가 활성화되어 있는지 확인하세요
5. 변경 사항을 적용하려면 Cursor IDE를 다시 시작하세요.

방법 2: 수동 구성

1. .cursor 디렉토리가 있는지 확인하세요.
   mkdir -p .cursor
2. MCP 구성 파일을 만듭니다.
   cat > .cursor/mcp.json << 'EOF' { "mcpServers": { "n8n-workflow-builder": { "command": "node", "args": ["/absolute/path/to/n8n-workflow-builder-mcp/dist/index.js"] } } } EOF
   /absolute/path/to 시스템의 실제 경로로 바꿔야 합니다.
3. 변경 사항을 적용하려면 Cursor IDE를 다시 시작하세요.

사용 가능한 MCP 도구

서버는 n8n 워크플로 작업을 위한 다음과 같은 도구를 제공합니다.

커서 통합 문제 해결

MCP 서버가 Cursor와 함께 작동하는 데 문제가 있는 경우 다음 단계를 시도해 보세요.

1. 커서 재시작 : MCP 구성을 설정한 후 커서를 완전히 닫았다가 다시 시작합니다.
2. 커서 MCP 설정 확인 :
   • 커서 설정 열기
   • 기능 > MCP 서버로 이동하세요
   • 서버가 나열되어 있고 활성화되어 있는지 확인하세요.
   • 나열되어 있지만 작동하지 않는 경우 새로 고침 버튼을 클릭해 보세요.
3. 서버 로그 확인 : 서버를 실행 중인 터미널이나 커서 출력 패널에서 오류를 확인하세요. MCP 관련 로그를 보려면 출력 패널의 드롭다운 메뉴에서 "커서 MCP"를 선택하세요.
4. 파일 권한 확인 : dist/index.js 파일에 실행 권한이 있는지 확인하세요.
5. 포트 충돌 확인 : 다른 MCP 서버가 실행 중이면 충돌이 발생할 수 있습니다. 동일한 포트를 사용하는 다른 프로세스가 있는지 확인하세요.
6. 글로벌 설치 시도 : 로컬 경로를 사용하는 대신 서버를 글로벌하게 설치해보세요.
   npm install -g n8n-workflow-builder-mcp
   그런 다음 .cursor/mcp.json 파일을 업데이트하여 글로벌 명령을 사용합니다.

일반적인 문제 및 솔루션

"클라이언트 생성에 실패했습니다"

이는 일반적으로 다음과 같은 경우에 발생합니다.

• MCP 서버가 실행되지 않습니다.
• 커서와 서버 사이에 연결 문제가 있습니다.
• 초기화 중에 서버가 충돌했습니다.

노력하다:

1. 서버가 올바르게 작동하는지 확인하기 위해 테스트 스크립트를 실행합니다.
2. 서버 로그에서 오류 확인
3. 커서 재시작

MCP 서버가 커서에 표시되지 않습니다.

다음과 같은 경우 이런 일이 발생할 수 있습니다.

• .cursor/mcp.json 파일이 올바르게 포맷되지 않았습니다.
• 커서가 구성 변경을 감지하지 못했습니다.

노력하다:

1. .cursor/mcp.json 파일의 JSON 형식 검증
2. 커서 재시작
3. 커서 설정에서 서버를 수동으로 선택합니다(표시되는 경우)

MCP 서버가 표시되지만 도구를 사용할 수 없습니다.

다음과 같은 경우 이런 일이 발생할 수 있습니다.

• 서버가 도구를 제대로 등록하지 않습니다.
• ListOfferings 요청/응답에 문제가 있습니다.

노력하다:

1. 도구가 제대로 등록되었는지 확인하기 위해 테스트 스크립트를 실행합니다.
2. 커서의 MCP 서버 설정에서 새로 고침 버튼을 클릭합니다.
3. 서버 로그에서 오류가 있는지 확인합니다.

프로젝트 구조

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

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기

특허

라이센스 작업 중 - n8n 팀의 확인이 필요합니다.