GitHub Projects MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides integration with GitHub's Projects v2 API for Agile project management, allowing for managing GitHub Projects, Issues, and Repositories through a Model Context Protocol server.

  • Utilizes GraphQL for interacting with GitHub's Projects v2 API, supporting queries and mutations for projects, fields, items and other GitHub resources.

GitHub 프로젝트 MCP 서버

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

특징

  • GitHub 프로젝트 v2 API : GitHub의 GraphQL 프로젝트 v2 API에 대한 전체 지원
  • GitHub 이슈 : GitHub 이슈 생성, 읽기, 업데이트
  • GitHub 저장소 : 저장소 세부 정보 가져오기
  • 유형 안전성 : 최대 유형 안전성을 위해 TypeScript로 구축됨

설치

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 프로젝트 생성, 읽기, 업데이트 및 삭제
  • 프로젝트 필드, 항목 및 상태 업데이트 관리
  • 초안 문제를 실제 문제로 변환
  • 프로젝트 항목 보관 및 보관 취소

문제

  • 문제 세부 정보 받기
  • 프로젝트에 이슈 추가

저장소

  • 저장소 정보 가져오기

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

사용자가 자연어를 통해 GitHub의 Projects v2 API와 상호 작용하여 Agile 프로젝트 관리를 수행하고, 저장소 세부 정보, 문제 추적 및 프로젝트 보드 관리 작업을 지원할 수 있습니다.

  1. Features
    1. Installation
      1. Installing via Smithery
    2. Usage
      1. Manual Installation
    3. Environment Variables
      1. GitHub Token Permissions
        1. Development
          1. Commands
        2. Project Structure
          1. Available Operations
            1. Projects
            2. Issues
            3. Repositories
          ID: 86aw338aa5