github-projects-mcp

GitHub 프로젝트 V2 MCP 서버

Claude 및 기타 MCP 클라이언트를 통해 GitHub Projects V2를 관리하는 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 GitHub Projects V2와 상호 작용하기 위해 GitHub GraphQL API를 사용합니다.

특징

• 사용자 및 조직을 위한 GitHub 프로젝트 V2 목록 및 보기
• 프로젝트 필드 및 항목(이슈, PR, 초안 이슈) 가져오기
• 이슈를 생성하고 프로젝트에 추가하세요
• 프로젝트에서 직접 초안 이슈를 생성합니다.
• 프로젝트 항목 필드 값 업데이트
• 프로젝트에서 항목 삭제

용법

이 서버는 Claude Desktop과 같은 모든 MCP 클라이언트와 함께 사용할 수 있습니다. MCP 클라이언트 구성(예: claude_desktop_config.json )에 추가하세요.

옵션 1: 게시된 패키지 사용

다음은 uvx 명령 실행기로 사용하는 구성의 예입니다.

지엑스피1

your_pat_here 실제 GitHub 개인 액세스 토큰으로 바꿔야 합니다.

옵션 2: 소스 코드에서

소스 코드에서 직접 프로젝트를 실행하려면 다음 단계를 따르세요.

설정

1. 저장소를 복제합니다.
   git clone git@github.com:Arclio/github-projects-mcp.git cd github-projects-mcp
2. 가상 환경을 만들고 활성화하세요.
   uv venv source venv/bin/activate
3. 종속성 설치:
   uv pip install -e .
4. GitHub 토큰을 환경 변수로 설정하세요.GitHub 개인 액세스 토큰을 생성 하고 필요한 권한을 부여하세요. 필요한 권한은 repo , project , read:org 입니다.다음 명령을 실행한 후 .env 파일에 토큰을 추가하세요.
   cp .env.example .env
   그런 다음 .env 파일에 다음을 추가합니다.
   export GITHUB_TOKEN=your_personal_access_token

소스 코드에서의 사용

소스 코드에서 사용할 경우 MCP 클라이언트를 다음과 같이 구성하세요.

/path/to/github-projects-mcp 와 your_pat_here 실제 저장소 경로와 GitHub 개인 액세스 토큰으로 바꿔야 합니다.

사용 가능한 도구

• list_projects : 지정된 조직 또는 사용자에 대한 GitHub 프로젝트 V2를 나열합니다.
• get_project_fields : GitHub 프로젝트 V2에서 사용 가능한 필드 가져오기
• get_project_items : GitHub 프로젝트 V2에서 항목을 가져옵니다(상태 또는 사용자 지정 단일 선택 필드 필터링 지원)
• create_issue : 새로운 GitHub 이슈를 생성합니다.
• add_issue_to_project : 기존 GitHub 이슈를 Project V2에 추가합니다.
• update_project_item_field : 프로젝트 항목의 필드 값을 업데이트합니다.
• create_draft_issue : GitHub 프로젝트 V2에서 직접 초안 이슈를 생성합니다.
• delete_project_item : GitHub 프로젝트 V2에서 항목을 삭제합니다.

자세한 사용 정보는 서버 코드의 도구 설명서를 참조하세요.

개발

이 프로젝트는 다음과 같이 구성됩니다.

• src/github_projects_mcp/ : 메인 패키지 디렉토리
  • server.py : 도구 정의를 사용한 MCP 서버 구현
  • github_client.py : GitHub API 상호작용을 위한 GraphQL 클라이언트

기여하려면 다음을 확인하세요.

1. 모든 GraphQL 작업에 적절한 오류 처리를 추가합니다.
2. 모든 함수와 매개변수에 대한 유형 주석 추가
3. 새로운 도구나 기능을 추가할 때 설명서를 업데이트하세요