맞춤형 GitHub 이슈 관리 MCP 서버 - n8n 워크플로우

• 이슈 추적에 AI 에이전트 통합을 모색하는 개발자 및 DevOps 팀.


• AI 에이전트가 자신의 GitHub 리포지토리에 접근하는 것에 대해 안전하고 세부적인 제어를 원하는 사용자.


• n8n 워크플로우 로직을 사용하여 맞춤형 AI 도구를 구축하려는 n8n 사용자.

이 특화된 n8n 워크플로우는 자신만의 맞춤형 GitHub MCP 서버를 구성하는 방법을 보여줍니다. 범용 서버에 의존하는 대신, 이 n8n 템플릿을 사용하면 AI 에이전트(예: Claude 또는 기타 MCP 클라이언트)에 대한 정확한 접근 권한과 기능을 정의할 수 있습니다. 핵심 가치는 보안 강화 및 사용자 정의이며, 에이전트가 지정된 GitHub 리포지토리에서 특정 보호된 작업만 수행하도록 보장합니다. n8n을 사용하여 로직을 관리함으로써, 이 기반을 쉽게 확장하여 풀 리퀘스트와의 상호 작용을 포함시키거나, 보고서를 생성하거나, 출력 구조를 사용자 정의할 수 있습니다. 이 접근 방식은 n8n 노드 생태계의 강력한 기능을 활용하여 견고한 AI 기반 솔루션을 만듭니다.

전체 자동화는 특수 n8n 트리거인 Github MCP 서버 노드에 의해 시작됩니다. 이 n8n 트리거는 호환되는 MCP 클라이언트(AI 에이전트 등)로부터 명령을 기다립니다. 에이전트가 호출할 수 있는 특정 GitHub 작업을 만드는 세 개의 전용 도구 워크플로우(Tool Workflow) 노드가 정의되어 있습니다: '최신 이슈 가져오기(Get Latest Issues)', '이슈 댓글 가져오기(Get Issue Comments)', '이슈 댓글 추가(Add Issue Comment)'.

1. 도구 호출: AI 에이전트가 이 도구 중 하나를 호출하면, 해당 명령은 '다른 워크플로우에 의해 실행될 때(When Executed by Another Workflow)' n8n 노드를 실행하며 operation, repo, issueNumber와 같은 매개변수를 전달합니다.


2. 라우팅: 'Operation'이라는 이름의 Switch n8n 노드가 operation 매개변수를 검사하여 흐름을 올바른 작업 분기로 라우팅합니다.


3. 작업 실행:

이 구조는 n8n 워크플로우가 기본 GitHub API와의 모든 상호 작용을 안전하게 처리하는 깔끔하고 모듈식 실행을 보장합니다.

이 강력한 n8n 워크플로우를 설치하려면 다음 단계를 따르세요.

1. n8n 워크플로우 가져오기: 제공된 JSON 데이터를 복사하여 n8n 인스턴스로 이동합니다. 'Workflows' > 'New' > 'Import from JSON'을 선택하고 코드를 붙여넣습니다.


2. GitHub 자격 증명 설정: 이 n8n 템플릿은 유효한 GitHub API 자격 증명을 필요로 합니다. GitHub n8n 노드가 API 인증에 사용할 수 있도록 자격 증명 리소스를 설정해야 합니다. 이 계정이 대상 리포지토리에 필요한 읽기 및 쓰기 권한을 가지고 있는지 확인하세요 (예: 기본 구성에 사용된 'n8n-io/n8n').


3. MCP 서버 n8n 트리거 구성: 'Github MCP Server' n8n 트리거를 활성화합니다. 운영 환경으로 전환하기 전에 보안을 위해 이 n8n 트리거에 인증을 활성화하는 것이 강력히 권장됩니다(Sticky Note에 언급된 대로).


4. 클라이언트 연결: MCP 서버 n8n 트리거가 생성한 엔드포인트 URL을 사용하여 선호하는 MCP 클라이언트(예: Claude Desktop)를 연결하고, 'MCP에 대한 최신 이슈 좀 가져와 줄래?'와 같은 쿼리 테스트를 시작합니다.

Github MCP Server (n8n 트리거): 전체 n8n 워크플로우의 시작점입니다. API 엔드포인트 역할을 하며, 모델 컨텍스트 프로토콜을 통해 AI 에이전트로부터 구조화된 명령을 기다립니다.
도구 워크플로우 (Tool Workflow, n8n 노드): 세 개의 별도 도구 워크플로우 노드('최신 이슈 가져오기', '이슈 댓글 가져오기', '이슈 댓글 추가')가 구성됩니다. 이들은 복잡한 GitHub 작업을 AI 에이전트가 지능적으로 호출할 수 있는 간단하고 설명적인 도구로 래핑합니다. 이들은 필요한 입력(예: issueNumber, text)을 정의합니다.
다른 워크플로우에 의해 실행될 때 (When Executed by Another Workflow, n8n 노드): 이는 도구 워크플로우가 동일한 n8n 워크플로우 인스턴스로 다시 호출될 때 내부 진입점 역할을 하며, 에이전트가 전달한 입력을 수신합니다.
Operation (Switch n8n 노드): 필수적인 흐름 제어 기능입니다. 이 n8n 노드는 operation 매개변수(getLatestIssues, getIssueComments, addIssueComment)를 기반으로 수신된 요청을 올바른 후속 GitHub 작업 분기로 동적으로 라우팅합니다.
GitHub (n8n 노드): 핵심 작업을 위해 각 분기에서 사용됩니다: '다수의 이슈 가져오기'(최신 이슈 찾기), '단일 이슈 가져오기'(댓글 가져오기 시작), 및 '댓글 생성'(이슈에 응답)입니다. 구성에서는 표현식을 사용하여 수신된 데이터에서 리포지토리 및 이슈 번호를 가져옵니다.
HTTP 요청 (HTTP Request, n8n 노드): getIssueComments 흐름에서 특히 사용되며, 초기 이슈 페이로드에 제공된 전용 URL을 사용하여 댓글을 가져오고 인증된 액세스를 요구합니다.

• Set (n8n 노드): 광범위하게 사용됩니다(예: '이슈 간소화', '댓글 간소화'). GitHub n8n 노드가 반환하는 데이터를 정리하고 구조화하여 최종 출력이 AI 에이전트에게 간결하고 관련성 있도록 보장합니다.