github-workflow-mcp

Claude Code에 자연어 지시 한 번으로 GitHub 워크플로우(브랜치 생성 → 테스트 → 커밋/push → PR)를 자동화하는 MCP 서버.

제공 도구

Related MCP server: GitHub MCP Server

설치

# 이 레포를 클론한 후
npm install
npm link   # 또는 팀 레포에서: npm install /path/to/github-workflow-mcp

환경 변수

GitHub Token 발급: Settings → Developer settings → Personal access tokens → repo 스코프 체크

Claude Code 설정

~/.claude/settings.json 또는 .claude/settings.json에 추가:

{
  "mcpServers": {
    "github-workflow": {
      "command": "github-workflow-mcp",
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "REPO_OWNER": "myorg",
        "REPO_NAME": "my-project",
        "REPO_PATH": "/Users/me/projects/my-project"
      }
    }
  }
}

사용 예시

Claude Code에 다음과 같이 지시하면 됩니다:

로그인 버튼 기능을 추가해줘.
feature/login-button 브랜치를 만들고, 코드 작성 후 테스트 통과하면 PR까지 열어줘.

Claude Code가 자동으로 아래 순서로 MCP 도구를 호출합니다:

1. create_branch("feature/login-button", "main")

2. (코드 작성)

3. run_tests() → 실패 시 코드 수정 후 재시도

4. commit_and_push("feat: add login button")

5. create_pr("Add login button", "...", "feature/login-button")

테스트

npm test

run_workflow 사용 예시 (Part A)

ANTHROPIC_API_KEY만 추가로 설정하면 완전 자동화 도구가 활성화됩니다:

{
  "mcpServers": {
    "github-workflow": {
      "command": "github-workflow-mcp",
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "REPO_OWNER": "myorg",
        "REPO_NAME": "my-project",
        "REPO_PATH": "/Users/me/projects/my-project",
        "ANTHROPIC_API_KEY": "sk-ant-your_key_here"
      }
    }
  }
}

Claude Code에 한 마디만 하면 됩니다:

run_workflow로 "사용자 프로필 페이지에 아바타 업로드 기능 추가" 해줘

내부 동작:

1. feature/사용자-프로필-페이지에-아바타 브랜치 자동 생성

2. Claude API가 코드 작성

3. 테스트 실행 → 실패 시 Claude가 자동 수정 (최대 3회)

4. 커밋 + push + PR 오픈

보안 참고

• run_tests의 command 파라미터는 npm test, yarn test, pnpm test, python -m pytest만 허용

• GITHUB_TOKEN은 각자 개인 PAT를 사용 (커밋이 본인 이름으로 기록됨)

• REPO_PATH는 MCP 설정에서 명시적으로 지정 (임의 경로 접근 방지)