GitHub 프로젝트 MCP 서버

GitHub Projects를 사용하여 AI 에이전트가 Agile Sprint 기반 프로젝트를 만들고 관리할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.

특징

• GitHub 프로젝트 v2 API : GitHub의 GraphQL 프로젝트 v2 API에 대한 전체 지원

• GitHub 이슈 : GitHub 이슈 생성, 읽기, 업데이트

• GitHub 저장소 : 저장소 세부 정보 가져오기

• 유형 안전성 : 최대 유형 안전성을 위해 TypeScript로 구축됨

Related MCP server: GitHub Enterprise MCP Server

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 GitHub Projects MCP Server를 자동으로 설치하는 방법:

지엑스피1

용법

수동 설치

1. 이 저장소를 복제하세요:

   git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git
   cd mcp-github-projects

2. 종속성 설치:

   bun install

3. GitHub 토큰으로 .env 파일을 만듭니다.

   GITHUB_TOKEN=your_github_personal_access_token
   GITHUB_OWNER=your_github_username

4. 서버를 빌드하세요:

   bun run build

5. 다음 설정으로 MCP 클라이언트를 구성하세요.

{
  "mcpServers": {
    "GitHubProjects": {
      "command": "bun",
      "args": [
        "/path/to/your/directory/mcp-github-projects-main/build/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token",
        "GITHUB_OWNER": "your_github_username_or_org"
      }
    }
  }
}

환경 변수

• GITHUB_TOKEN : 적절한 권한이 있는 GitHub 개인 액세스 토큰

• GITHUB_OWNER : GitHub 사용자 이름 또는 조직 이름

GitHub 토큰 권한

이 MCP 서버에는 다음 권한이 있는 GitHub 개인 액세스 토큰(클래식)이 필요합니다.

• project - 프로젝트에 대한 전체 제어

• read:project - 프로젝트의 읽기 권한

• repo - 개인 저장소에 대한 전체 제어

• repo:status - 커밋 상태 접근

• repo_deployment - 배포 상태 액세스

• public_repo - 공개 저장소에 액세스

• repo:invite - 저장소 초대에 액세스

• security_events - 보안 이벤트 읽기 및 쓰기

개발

명령

• 빌드: bun run build

• GraphQL 유형 생성: bun run graphql-codegen

프로젝트 구조

이 프로젝트는 GitHub의 GraphQL API를 위한 MCP 서버로, 프로젝트 V2 운영에 중점을 두고 있습니다. 코드베이스는 GraphQL을 통해 GitHub 프로젝트 기능에 대한 형식화된 접근을 제공합니다.

사용 가능한 작업

프로젝트

• GitHub 프로젝트 생성, 읽기, 업데이트 및 삭제

• 프로젝트 필드, 항목 및 상태 업데이트 관리

• 초안 문제를 실제 문제로 변환

• 프로젝트 항목 보관 및 보관 취소

문제

• 문제 세부 정보 받기

• 프로젝트에 이슈 추가

저장소

• 저장소 정보 가져오기