GitHub MCP 서버
Cline을 통해 GitHub 문제와 상호작용하기 위한 MCP(모델 컨텍스트 프로토콜) 서버 구현입니다.
특징
저장소에서 GitHub 이슈 나열
새로운 GitHub 이슈 생성
오류 처리 및 검증
환경 변수를 통한 보안 인증
Related MCP server: GitHub MCP Server
설치
저장소를 복제합니다.
지엑스피1
uv를 사용하여 종속성을 설치합니다.
pip install uv
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt
환경 템플릿을 복사하고 GitHub 토큰을 구성하세요.
cp .env.template .env
.env 편집하고 GitHub 개인 액세스 토큰을 추가하세요.
GITHUB_TOKEN=your_token_here
GitHub 개인 액세스 토큰을 생성하려면:
GitHub 설정 -> 개발자 설정 -> 개인 액세스 토큰으로 이동하세요.
repo범위로 새 토큰 생성토큰을 복사하여
.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 .