mcp-n8n-빌더

n8n 워크플로의 프로그래밍 방식 생성 및 관리를 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 n8n의 REST API와 상호 작용할 수 있는 도구와 리소스를 제공하여 AI 비서가 사용자의 직접적인 개입 없이 워크플로를 구축, 수정 및 관리할 수 있도록 지원합니다.

특징

🔄 워크플로 관리 : 워크플로 생성, 읽기, 업데이트, 삭제, 활성화 및 비활성화
📊 실행 관리 : 워크플로 실행 세부 정보를 나열하고 검색합니다.
✅ 스키마 검증 : Zod를 사용하여 입력 및 출력 데이터 모두에 대한 포괄적인 검증
🔍 노드 검증 : 워크플로 생성 전에 n8n의 사용 가능한 노드에 대해 노드 유형을 검증하여 오류를 방지합니다.
🤔 스마트 제안 : 유효하지 않은 노드가 감지되면 유사한 노드 유형에 대한 제안을 제공합니다.
🛠️ 오류 처리 : 문제 해결을 위한 자세한 오류 메시지
📝 문서 : 모든 도구와 리소스에 대한 광범위한 문서
🔍 검색 및 필터링 : 이름, 태그 또는 활성 상태별로 워크플로 필터링

구성

이 서버를 사용하려면 MCP 클라이언트를 통한 구성이 필요합니다. 다음은 다양한 환경에 대한 예시입니다.

클라인 구성

Cline MCP 설정에 다음을 추가하세요.

지엑스피1

WSL 구성을 사용한 Claude Desktop

WSL 환경의 경우 Claude Desktop 구성에 다음을 추가하세요.

{
	"mcpServers": {
		"n8n-workflow-builder": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"N8N_HOST=http://localhost:5678/api/v1 N8N_API_KEY=your-n8n-api-key OUTPUT_VERBOSITY=concise npx -y mcp-n8n-builder"
			]
		}
	}
}

환경 변수

서버는 환경 변수를 사용하여 구성할 수 있습니다.

변하기 쉬운	설명	기본
`N8N_HOST`	n8n API의 URL	`http://localhost:5678/api/v1`
`N8N_API_KEY`	n8n 인증을 위한 API 키	`""`
`SERVER_NAME`	MCP 서버의 이름	`"n8n-workflow-builder"`
`SERVER_VERSION`	MCP 서버 버전	패키지 버전
`LOG_LEVEL`	로깅 레벨	`"info"`
`CACHE_ENABLED`	캐싱 활성화	`false`
`CACHE_TTL`	캐시 TTL(초)	`300`
`OUTPUT_VERBOSITY`	출력 상세 수준( `concise` 또는 `full` )	`"concise"`

MCP 도구

노드 관리

list_available_nodes : n8n 인스턴스에서 사용 가능한 모든 노드를 나열합니다. 중요 : 워크플로를 생성하거나 업데이트하기 전에 이 도구를 사용하여 유효한 노드 유형만 사용하세요. 이렇게 하면 현재 n8n 인스턴스에 없는 노드 유형을 사용하여 발생하는 오류를 방지할 수 있습니다.

워크플로 관리

list_workflows : n8n의 모든 워크플로를 ID, 이름, 상태, 생성일, 태그 등 기본 정보와 함께 나열합니다. 활성 상태, 태그 또는 이름으로 결과를 필터링할 수 있습니다.
create_workflow : 지정된 노드와 연결을 사용하여 n8n에 새 워크플로를 생성합니다. 생성된 워크플로와 할당된 ID를 반환합니다. n8n 인스턴스에 모든 노드 유형이 있는지 확인합니다.
get_workflow : 모든 노드, 연결, 설정 및 메타데이터를 포함하여 ID로 특정 워크플로의 전체 세부 정보를 검색합니다.
update_workflow : 기존 워크플로를 새 구성으로 업데이트합니다. 변경되는 부분뿐만 아니라 전체 워크플로 구조를 제공해야 합니다. n8n 인스턴스에 모든 노드 유형이 있는지 확인합니다.
delete_workflow : ID별로 워크플로를 영구적으로 삭제합니다. 이 작업은 실행 취소할 수 없습니다.
activate_workflow : ID로 워크플로를 활성화하여 트리거에 따라 자동으로 실행되도록 합니다.
deactivate_workflow : ID로 워크플로를 비활성화하여 자동 실행을 방지합니다.

실행 관리

list_executions : 성공/실패 상태, 지속 시간 및 타임스탬프에 대한 세부 정보가 포함된 워크플로 실행 내역을 나열합니다. 결과는 워크플로 ID, 상태별로 필터링할 수 있으며, 특정 개수로 제한할 수도 있습니다.
get_execution : 실행 시간, 상태, 그리고 선택적으로 각 단계에서 처리된 전체 데이터를 포함하여 특정 워크플로 실행에 대한 자세한 정보를 검색합니다.

MCP 리소스

n8n://workflows : n8n의 모든 워크플로 목록
n8n://workflows/{id} : 특정 n8n 워크플로의 세부 정보
n8n://executions/{id} : 특정 n8n 워크플로 실행의 세부 정보

개발

설정

저장소를 복제합니다
종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

개발 모드에서 실행:

npm run dev

출판

이 프로젝트에서는 버전 관리를 위해 변경 세트를 사용합니다. 게시하려면 다음을 수행하세요.

변경 세트를 만듭니다.

npm changeset

패키지 버전:

npm changeset version

npm에 게시:

npm release

기여하다

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

특허

MIT 라이센스 - 자세한 내용은 LICENSE 파일을 참조하세요.

감사의 말

모델 컨텍스트 프로토콜을 기반으로 구축됨
n8n 으로 구동됨

mcp-n8n-builder

Integrations