n8n 워크플로 빌더 MCP 서버

이 프로젝트는 n8n 워크플로 관리를 위한 MCP 서버를 제공합니다. 정의된 도구 세트를 통해 워크플로를 나열, 생성, 업데이트, 삭제, 활성화 및 비활성화하는 기능을 제공합니다.

중요한:
이 버전은 패키지 관리와 서버 실행을 위해 npm 만을 지원합니다. (npx 지원은 향후 업데이트에서 다시 도입될 예정입니다.)

요구 사항

• Node.js(v14 이상 권장)
• 엔피엠

광범위한 설치 가이드

1. 저장소 복제

원하는 소스에서 저장소를 복제하세요. 예:

지엑스피1

그런 다음 프로젝트 디렉토리로 이동합니다.

2. 종속성 설치

npm을 사용하여 필요한 종속성을 설치합니다.

이 명령은 package.json 파일에 정의된 모든 필수 패키지를 다운로드하고 설치합니다.

3. 빌드 및 테스트

서버를 테스트하고 온라인 상태로 만들려면 다음 명령을 사용하세요.

• 프로젝트를 빌드하세요:
  이렇게 하면 TypeScript 파일이 컴파일되고 build 디렉토리에 실행 가능한 JavaScript가 생성됩니다.
  npm run build
• MCP 서버를 시작합니다.
  다음을 사용하여 서버를 시작합니다.
  npm start

서버가 시작되고 stdio를 통해 연결됩니다. 콘솔에서 서버가 정상적으로 시작되었음을 확인하는 메시지를 확인할 수 있습니다.

4. 배포

테스트 목적으로 서버를 온라인 상태로 만들려면 위에 언급된 빌드 및 시작 명령을 사용하세요. 현재 권장되는 방법은 다음과 같은 기본 워크플로(설치, 빌드, 시작)입니다.

5. 추가 구성

서버 구성은 cline_mcp_settings.json 파일을 통해 관리됩니다. 다음 환경 변수가 올바르게 설정되어 있는지 확인하세요.

• N8N_HOST : n8n API 호스트 URL입니다.
• N8N_API_KEY : n8n API 키.

cline_mcp_settings.json 의 구성 예:

사용 가능한 기능

MCP 도구

다음 도구는 서버에 정의되어 있으며 MCP 클라이언트를 통해 액세스할 수 있습니다.

워크플로 관리

• list_workflows : n8n의 모든 워크플로를 나열합니다.
• create_workflow : n8n에서 새로운 워크플로를 만듭니다.
• get_workflow : ID로 워크플로를 검색합니다.
• update_workflow : 기존 워크플로를 업데이트합니다.
• delete_workflow : ID로 워크플로를 삭제합니다.
• activate_workflow : ID로 워크플로를 활성화합니다.
• deactivate_workflow : ID로 워크플로를 비활성화합니다.

실행 관리

• list_executions : 선택적 필터를 사용하여 모든 워크플로 실행을 나열합니다.
• get_execution : ID로 특정 실행의 세부 정보를 검색합니다.
• delete_execution : ID로 실행을 삭제합니다.

MCP 리소스

서버는 또한 보다 효율적인 컨텍스트 액세스를 위해 다음과 같은 리소스를 제공합니다.

정적 리소스

• /workflows : n8n 인스턴스에서 사용 가능한 모든 워크플로 목록
• /execution-stats : 워크플로 실행에 대한 요약 통계

동적 리소스 템플릿

• /workflows/{id} : 특정 워크플로에 대한 자세한 정보
• /executions/{id} : 특정 실행에 대한 자세한 정보

문제 해결

• npm을 사용하고 있는지 확인하세요(이 버전은 npx를 지원하지 않습니다).
• 문제가 발생하면 빌드 디렉터리를 정리하고 다시 빌드해보세요.
  npm run clean && npm run build
• cline_mcp_settings.json 의 환경 변수가 올바른지 확인하세요.

향후 개선 사항

• npx 지원이 다시 도입되었습니다.
• 추가 도구 및 워크플로 기능.
• 배포 및 확장이 더욱 향상되었습니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.