n8n MCP 도구

n8n API 통합을 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현. 이 프로젝트는 MCP 프로토콜을 사용하여 n8n 워크플로와 AI 어시스턴트 간의 원활한 통합을 지원합니다.

특징

n8n의 공개 API(v1.1.1)의 완전한 구현
모든 API 엔드포인트를 위한 MCP 도구
Swagger 문서가 포함된 RESTful API 서버
확장성을 위한 모듈형 아키텍처
인증 미들웨어

구조

이 프로젝트는 다음 구성 요소로 구성됩니다.

api/endpoints/ : 각 리소스 유형에 대한 API 엔드포인트 구현
api/schemas/ : 데이터 모델 스키마 정의
api/tools/ : 각 리소스 유형에 대한 MCP 도구 구현
api/index.js : 메인 서버 진입점
api/config.js : 구성 설정

시작하기

필수 조건

Node.js(v14 이상)
npm 또는 yarn
API 키가 있는 n8n 인스턴스

설치

패키지로

지엑스피1

출처에서

저장소를 복제합니다.
git clone https://github.com/yourusername/n8n-mcp-tools.git cd n8n-mcp-tools
종속성 설치:
npm install
구성을 사용하여 .env 파일을 만듭니다.
N8N_API_BASE_URL=https://your-n8n-instance.com/api/v1 N8N_API_KEY=your-api-key PORT=3000
서버를 시작합니다:
npm start
API 문서에 접근하세요:
http://localhost:3000/api-docs

MCP 도구

MCP 도구를 사용하면 AI 어시스턴트가 자연어를 통해 n8n과 상호 작용할 수 있습니다. 다음은 몇 가지 도구 예시입니다.

사용자 도구

get-users : n8n 인스턴스의 모든 사용자를 가져옵니다.
get-user : ID 또는 이메일로 특정 사용자를 가져옵니다.
create-users : 하나 이상의 사용자를 생성합니다
delete-user : ID 또는 이메일로 사용자 삭제
change-user-role : 사용자의 글로벌 역할을 변경합니다.

워크플로 도구

get-workflows : n8n 인스턴스에서 모든 워크플로를 가져옵니다.
get-workflow : ID로 특정 워크플로 가져오기
create-workflow : 새로운 워크플로우를 생성합니다
update-workflow : 기존 워크플로 업데이트
delete-workflow : ID로 워크플로 삭제
activate-workflow : 워크플로 활성화
deactivate-workflow : 워크플로 비활성화
get-workflow-tags : 워크플로에 대한 태그 가져오기
update-workflow-tags : 워크플로에 대한 태그 업데이트
transfer-workflow : 워크플로를 다른 프로젝트로 전송

그리고 자격 증명, 실행, 태그, 변수, 프로젝트 및 감사 기능을 위한 다양한 도구가 있습니다.

구성

환경 변수를 사용하거나 api/config.js 수정하여 서버를 구성할 수 있습니다.

N8N_API_BASE_URL : n8n API의 기본 URL
N8N_API_KEY : 인증을 위한 API 키
PORT : 서버를 실행할 포트
HOST : 서버를 바인딩할 호스트
LOG_LEVEL : 로깅 레벨(정보, 오류, 디버그)
MCP_SOCKET_PATH : MCP 소켓 경로(STDIO 전송용)
MCP_USE_TCP : MCP 전송에 TCP를 사용할지 여부
MCP_TCP_PORT : MCP 전송을 위한 TCP 포트
MCP_TCP_HOST : MCP 전송을 위한 TCP 호스트

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

출판

이 패키지에 기여하고 새 버전을 게시해야 하는 경우:

package.json에서 버전을 업데이트합니다.
npm version patch # for bug fixes npm version minor # for new features npm version major # for breaking changes
npm에 게시:
npm publish
postversion 스크립트는 자동으로 새 버전을 GitHub에 푸시합니다.

기여하다

기여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.

변경 사항

각 버전의 변경 사항에 대한 자세한 내용은 CHANGELOG.md 파일을 참조하세요.

n8n MCP Tools

Integrations