GitHub MCP 도구

Claude Desktop을 통해 GitHub API와 상호 작용하기 위한 Multi-Claude 프로그램(MCP)입니다.

특징

• GitHub 저장소 및 이슈 검색
• GitHub 이슈와 풀 리퀘스트를 생성, 업데이트, 관리합니다.
• 저장소 설정 및 구성 관리
• 저장소 워크플로 및 작업 처리
• 사용자 및 조직 검색
• 저장소 협력자 및 팀 관리

설치

1. 이 저장소를 복제하세요:지엑스피1
2. 가상 환경을 만들고 활성화하세요.
   # On macOS/Linux python -m venv venv source venv/bin/activate # On Windows python -m venv venv .\venv\Scripts\activate
3. 종속성 설치:
   pip install -r requirements.txt
4. 프로젝트 루트에 .env 파일을 만듭니다.
   touch .env
5. .env 파일에 GitHub 자격 증명을 추가합니다.
   GITHUB_TOKEN=your_personal_access_token_here GITHUB_USERNAME=your_github_username
6. 설치를 테스트하세요:
   # Run all tests python -m pytest # Run a specific test file python -m pytest tests/test_search_repos.py
7. MCP 서버를 시작합니다.
   python run.py

환경 설정

GitHub 개인 액세스 토큰

GitHub에서 인증하려면 세분화된 개인 액세스 토큰이 필요합니다.

1. GitHub 계정에 로그인하세요
2. 설정 > 개발자 설정 > 개인 액세스 토큰 > 세분화된 토큰으로 이동하세요.
3. "새 토큰 생성"을 클릭하세요
4. 토큰을 구성하세요:
   • 토큰 이름: "Claude Desktop Integration"
   • 설명: "Claude Desktop GitHub 통합을 위한 토큰"
   • 만료일: 적절한 만료일을 선택하세요
   • 저장소 액세스: "모든 저장소" 또는 특정 저장소를 선택하세요.
   • 권한:
     • 저장소 권한:
       • 작업: 읽기 및 쓰기
       • 내용: 읽고 쓰기
       • 문제: 읽기 및 쓰기
       • 풀 리퀘스트: 읽기 및 쓰기
       • 저장소 후크: 읽기 및 쓰기
       • 저장소 설정: 읽기 및 쓰기
     • 조직 권한(조직 저장소를 사용하는 경우):
       • 회원: 읽기 전용
       • 팀: 읽기 전용
5. "토큰 생성"을 클릭하고 생성된 토큰을 안전하게 저장하세요.

도구

저장소 검색

다양한 기준을 사용하여 GitHub 저장소를 검색합니다.

매개변수:

• 쿼리: 검색 쿼리 문자열
• 정렬: 필드 정렬(별점, 포크, 업데이트 등)
• order: 정렬 순서(오름차순 또는 내림차순)
• max_results: 반환할 최대 결과 수(기본값: 10)

문제 생성

지정된 저장소에 새로운 GitHub 이슈를 만듭니다.

매개변수:

• 소유자: 저장소 소유자
• repo: 저장소 이름
• 제목: 이슈 제목
• 본문: 문제 설명
• 레이블: 적용할 레이블 목록
• 담당자: 담당자 사용자 이름 목록

풀 리퀘스트 생성

새로운 풀 리퀘스트를 만듭니다.

매개변수:

• 소유자: 저장소 소유자
• repo: 저장소 이름
• 제목: 홍보 제목
• 본문: PR 설명
• 헤드: 소스 브랜치
• 베이스: 타겟 브랜치
• draft: PR을 초안으로 생성할지 여부

저장소 설정 관리

저장소 설정 및 구성을 업데이트합니다.

매개변수:

• 소유자: 저장소 소유자
• repo: 저장소 이름
• 설정: 업데이트할 설정 사전

검색 문제

저장소 전체에서 문제를 검색합니다.

매개변수:

• 쿼리: 검색 쿼리 문자열
• 상태: 문제 상태(열림, 닫힘, 모두)
• 정렬: 필드 정렬
• 순서: 정렬 순서
• max_results: 최대 결과 수

워크플로 관리

GitHub Actions 워크플로를 관리합니다.

매개변수:

• 소유자: 저장소 소유자
• repo: 저장소 이름
• workflow_file: 워크플로 파일 경로
• action: 수행할 작업(활성화, 비활성화, 트리거)

공동작업자 관리

저장소 협력자를 관리합니다.

매개변수:

• 소유자: 저장소 소유자
• repo: 저장소 이름
• 사용자 이름: 협력자 사용자 이름
• 권한: 권한 수준(풀, 푸시, 관리, 유지 관리, 분류)

사용 예

개발

테스트 실행

새로운 도구 추가

1. src/tools/ 에 새 파일을 만듭니다.
2. 도구 기능을 구현하세요
3. src/main.py 에 도구를 등록합니다.
4. tests/ 에 테스트 추가
5. README.md에 설명서 업데이트

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치 생성
3. 변경 사항을 만드세요
4. 테스트 실행
5. 풀 리퀘스트 제출

특허

MIT 라이센스