GitHub MCP 도구

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

특징

• GitHub 저장소 및 이슈 검색

• GitHub 이슈와 풀 리퀘스트를 생성, 업데이트, 관리합니다.

• 저장소 설정 및 구성 관리

• 저장소 워크플로 및 작업 처리

• 사용자 및 조직 검색

• 저장소 협력자 및 팀 관리

Related MCP server: GitHub MCP Server

설치

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: 저장소 이름

• 사용자 이름: 협력자 사용자 이름

• 권한: 권한 수준(풀, 푸시, 관리, 유지 관리, 분류)

사용 예

# Search for repositories
search_repos(query="python web framework", sort="stars", max_results=5)

# Create a new issue
create_issue(
    owner="username",
    repo="repository",
    title="Bug: Login not working",
    body="Users cannot log in using the login button",
    labels=["bug", "high-priority"]
)

# Create a pull request
create_pull_request(
    owner="username",
    repo="repository",
    title="Feature: Add user authentication",
    body="Implements JWT-based authentication",
    head="feature/auth",
    base="main"
)

# Search for issues
search_issues(query="is:open is:issue author:username", max_results=10)

# Manage repository settings
manage_repo_settings(
    owner="username",
    repo="repository",
    settings={
        "has_issues": True,
        "has_projects": True,
        "has_wiki": True
    }
)

개발

테스트 실행

# Run all tests
python -m pytest

# Run with coverage
python -m pytest --cov=src tests/

# Run specific test file
python -m pytest tests/test_search_repos.py

새로운 도구 추가

1. src/tools/ 에 새 파일을 만듭니다.

2. 도구 기능을 구현하세요

3. src/main.py 에 도구를 등록합니다.

4. tests/ 에 테스트 추가

5. README.md에 설명서 업데이트

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치 생성

3. 변경 사항을 만드세요

4. 테스트 실행

5. 풀 리퀘스트 제출

특허

MIT 라이센스