GitHub 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

  • Allows to list and create GitHub issues from a repository

GitHub MCP 서버

Cline을 통해 GitHub 문제와 상호작용하기 위한 MCP(모델 컨텍스트 프로토콜) 서버 구현입니다.

특징

  • 저장소에서 GitHub 이슈 나열
  • 새로운 GitHub 이슈 생성
  • 오류 처리 및 검증
  • 환경 변수를 통한 보안 인증

설치

  1. 저장소를 복제합니다.

지엑스피1

  1. uv를 사용하여 종속성을 설치합니다.
pip install uv uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -r requirements.txt
  1. 환경 템플릿을 복사하고 GitHub 토큰을 구성하세요.
cp .env.template .env

.env 편집하고 GitHub 개인 액세스 토큰을 추가하세요.

GITHUB_TOKEN=your_token_here

GitHub 개인 액세스 토큰을 생성하려면:

  1. GitHub 설정 -> 개발자 설정 -> 개인 액세스 토큰으로 이동하세요.
  2. repo 범위로 새 토큰 생성
  3. 토큰을 복사하여 .env 파일에 붙여넣으세요.

용법

MCP 서버를 실행합니다.

python -m src.mcp_github.server

서버가 시작되고 Cline에게 두 가지 도구가 공개됩니다.

이슈 가져오기

GitHub 저장소에서 문제 목록을 가져옵니다.

{ "repo": "owner/repo" }

이슈 생성

GitHub 저장소에 새로운 이슈를 생성합니다.

{ "repo": "owner/repo", "title": "Issue title", "body": "Issue description" }

오류 처리

서버는 일반적인 오류를 처리합니다.

  • GitHub 토큰이 없습니다
  • 잘못된 저장소 이름
  • 필수 매개변수가 없습니다
  • GitHub API 오류

오류 응답에는 문제 해결에 도움이 되는 설명 메시지가 포함되어 있습니다.

개발

이 프로젝트에서는 종속성 관리를 위해 uv를 사용합니다. 개발 환경을 설정하려면 다음을 수행하세요.

# Install all dependencies (including dev dependencies) uv pip install -r requirements.txt # Run tests pytest # Format code black . # Type checking mypy .
-
security - not tested
F
license - not found
-
quality - not tested

모델 컨텍스트 프로토콜을 통해 GitHub 문제와 상호 작용할 수 있으므로 사용자는 보안 인증을 통해 문제를 나열하고 생성할 수 있습니다.

  1. Features
    1. Installation
      1. Usage
        1. get_issues
        2. create_issue
      2. Error Handling
        1. Development
          ID: j37nzp7f8j