GitHub MCP 서버

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

특징

• 저장소에서 GitHub 이슈 나열

• 새로운 GitHub 이슈 생성

• 오류 처리 및 검증

• 환경 변수를 통한 보안 인증

Related MCP server: GitHub MCP Server

설치

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

지엑스피1

2. uv를 사용하여 종속성을 설치합니다.

pip install uv
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt

3. 환경 템플릿을 복사하고 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 .