프로젝트 소개

GitHub MCP 서버는 GitHub의 공식 Model Context Protocol(MCP) 구현으로, AI 도구를 GitHub 플랫폼에 직접 연결하도록 설계되었습니다. 이를 통해 AI 에이전트, 어시스턴트, 챗봇이 자연어 상호작용을 통해 저장소와 코드 파일을 읽고, 이슈와 풀 리퀘스트를 관리하며, 코드를 분석하고, 워크플로를 자동화할 수 있습니다. 주요 사용 사례는 저장소 관리(코드 탐색 및 쿼리, 파일 검색, 커밋 분석, 프로젝트 구조 이해), 이슈 및 PR 자동화(생성, 업데이트, 버그 분류, 변경 사항 검토, 프로젝트 보드 유지 관리), CI/CD 및 워크플로 인텔리전스(GitHub Actions 실행 모니터링, 빌드 실패 분석, 릴리스 관리), 코드 분석(보안 발견 사항 검토, Dependabot 경고 검토, 코드 패턴 이해), 팀 협업(토론 접근, 알림 관리, 팀 활동 분석)이 있습니다. 두 가지 배포 옵션을 사용할 수 있습니다. 원격 GitHub MCP 서버는 GitHub에서 호스팅하며 가장 간단한 설정을 제공하므로 원격 서버 지원이 있는 호환 MCP 호스트(VS Code 1.101+, Claude Desktop, Cursor, Windsurf 등)가 필요합니다. OAuth 또는 Personal Access Token 인증을 지원하며 VS Code, VS Code Insiders, Visual Studio용 원클릭 설치 버튼을 제공합니다. insiders 모드는 URL 경로 또는 헤더를 통해 실험적 기능에 조기 액세스를 제공합니다. 데이터 레지던시가 있는 GitHub Enterprise Cloud(ghe.com)가 지원되며, GitHub Enterprise Server는 로컬 버전이 필요합니다. 로컬 GitHub MCP 서버는 Docker(이미지: ghcr.io/github/github-mcp-server)로 실행하거나 Go로 소스에서 빌드할 수 있습니다. github.com에서 OAuth 로그인(토큰은 메모리에만 보관) 또는 GITHUB_PERSONAL_ACCESS_TOKEN을 통한 PAT 인증을 지원하며, PAT가 OAuth보다 우선합니다. --gh-host 플래그와 GITHUB_HOST 환경 변수는 GitHub Enterprise Server 또는 데이터 레지던시가 있는 Enterprise Cloud를 구성하며, 루프백 호스트를 제외하고 HTTPS가 강제됩니다. 도구 구성은 유연합니다. --toolsets 플래그 또는 GITHUB_TOOLSETS 환경 변수는 기능 그룹을 활성화하거나 비활성화하여 LLM의 도구 선택을 돕고 컨텍스트 크기를 줄입니다. 개별 도구는 --tools 또는 GITHUB_TOOLS로 지정할 수 있으며 도구 세트와 추가적으로 결합할 수 있습니다. 읽기 전용 모드는 쓰기 도구를 건너뜁니다. 특수 도구 세트에는 "all"(모든 것을 활성화)과 "default"(context, repos, issues, pull_requests, users)가 있습니다. insiders 모드는 로컬에서 --insiders 또는 GITHUB_INSIDERS=true로 사용할 수 있습니다. 설치 가이드는 Copilot CLI, JetBrains/Visual Studio/Eclipse/Xcode의 GitHub Copilot, Claude Desktop 및 Claude Code, OpenAI Codex, Cursor, OpenCode, Windsurf, Zed, Rovo Dev CLI, Google Gemini CLI를 포함한 많은 MCP 호스트를 다룹니다. 이 프로젝트에는 정책 및 거버넌스, OAuth 로그인, GitHub App 인증, 도구 이름 변경, 서버 구성, 원격 서버 설정에 관한 문서가 포함되어 있습니다.