GitHub MCP Server

GitHub MCP 서버
GitHub MCP 서버는 AI 도구를 GitHub 플랫폼에 직접 연결합니다. 이를 통해 AI 에이전트, 어시스턴트, 챗봇이 리포지토리와 코드 파일을 읽고, 이슈와 PR을 관리하고, 코드를 분석하고, 워크플로를 자동화할 수 있습니다. 모두 자연어 상호작용을 통해 이루어집니다.

사용 사례

리포지토리 관리: 접근 권한이 있는 모든 리포지토리에서 코드를 탐색하고 쿼리하며, 파일을 검색하고, 커밋을 분석하고, 프로젝트 구조를 파악합니다.
이슈 및 PR 자동화: 이슈와 풀 리퀘스트를 생성, 업데이트, 관리합니다. AI가 버그 분류, 코드 변경 리뷰, 프로젝트 보드 유지 관리를 돕도록 합니다.
CI/CD 및 워크플로 인텔리전스: GitHub Actions 워크플로 실행을 모니터링하고, 빌드 실패를 분석하고, 릴리스를 관리하고, 개발 파이프라인에 대한 인사이트를 얻습니다.
코드 분석: 보안 발견 사항을 검토하고, Dependabot 경고를 리뷰하고, 코드 패턴을 이해하고, 코드베이스에 대한 종합적인 인사이트를 얻습니다.
팀 협업: 토론에 접근하고, 알림을 관리하고, 팀 활동을 분석하고, 팀을 위한 프로세스를 간소화합니다.

간단한 자연어 쿼리부터 복잡한 다단계 에이전트 워크플로에 이르기까지, AI 도구를 GitHub 컨텍스트와 기능에 연결하려는 개발자를 위해 만들어졌습니다.

Go 모듈 사용
Go 모듈 경로는 github.com/github/github-mcp-server/v2 입니다. 라이브러리 소비자는
임포트에서 이 접두사를 사용해야 합니다. 예를 들어
github.com/github/github-mcp-server/v2/pkg/github 이며, go get 명령에서도 마찬가지입니다.
리포지토리 체크아웃에서 빌드할 때는 /v2 하위 디렉터리가 필요하지 않습니다.

기존 v2.0.0 태그는 이 모듈 경로 수정 이전의 것이므로 Go 모듈로
사용할 수 없습니다. 이 변경이 병합된 후에는 수정된 모듈 경로를 포함하는
커밋에서 v2.0.1과 같은 새 릴리스가 태그되어야 합니다. 그때까지는
소비자가 이 변경을 포함하는 커밋의 의사 버전(pseudo-version)을 사용할 수 있습니다.

원격 GitHub MCP 서버

원격 GitHub MCP 서버는 GitHub에서 호스팅하며, 가장 쉽게 시작하고 실행할 수 있는 방법을 제공합니다. MCP 호스트가 원격 MCP 서버를 지원하지 않더라도 걱정하지 마세요! 대신 로컬 버전의 GitHub MCP 서버를 사용할 수 있습니다.

사전 요구 사항

원격 서버를 지원하는 호환 MCP 호스트 (VS Code 1.101+, Claude Desktop, Cursor, Windsurf 등)
적용 가능한 정책 활성화

VS Code에 설치
빠른 설치를 위해 위의 원클릭 설치 버튼 중 하나를 사용하세요. 해당 흐름을 완료한 후 에이전트 모드(Copilot Chat 텍스트 입력 옆에 위치)를 켜면 서버가 시작됩니다. 원격 MCP 및 OAuth 지원을 위해 VS Code 1.101 이상을 사용하고 있는지 확인하세요.

또는 VS Code를 수동으로 구성하려면 아래 예시에서 적절한 JSON 블록을 선택하여 호스트 구성에 추가하세요:

OAuth 사용 GitHub PAT 사용
VS Code (버전 1.101 이상)

{
"servers" : {
"github" : {
"type" : " http " ,
"url" : " https://api.githubcopilot.com/mcp/ "
}
}
}

{
"servers" : {
"github" : {
"type" : " http " ,
"url" : " https://api.githubcopilot.com/mcp/ " ,
"headers" : {
"Authorization" : " Bearer ${input:github_mcp_pat} "
}
}
},
"inputs" : [
{
"type" : " promptString " ,
"id" : " github_mcp_pat " ,
"description" : " GitHub Personal Access Token " ,
"password" : true
}
]
}

다른 MCP 호스트에 설치

Copilot CLI - GitHub Copilot CLI 설치 가이드
다른 IDE의 GitHub Copilot - GitHub Copilot과 함께 JetBrains, Visual Studio, Eclipse, Xcode용 설치
Claude 애플리케이션 - Claude Desktop 및 Claude Code CLI 설치 가이드
Codex - OpenAI Codex 설치 가이드
Cursor - Cursor IDE 설치 가이드
OpenCode - OpenCode 터미널 에이전트 설치 가이드
Windsurf - Windsurf IDE 설치 가이드
Zed - Zed 에디터 설치 가이드
Rovo Dev CLI - Rovo Dev CLI 설치 가이드

참고: 각 MCP 호스트 애플리케이션은 OAuth를 통한 원격 액세스를 지원하기 위해 GitHub App 또는 OAuth App을 구성해야 합니다. 원격 MCP 서버를 지원하는 모든 호스트 애플리케이션은 PAT 인증을 통한 원격 GitHub 서버를 지원해야 합니다. 구성 세부 사항과 지원 수준은 호스트마다 다릅니다. 자세한 내용은 호스트 애플리케이션의 문서를 참조하세요.

구성
도구 세트 구성
원격 서버 구성, 도구 세트, 헤더, 고급 사용법에 대한 전체 세부 사항은 원격 서버 문서를 참조하세요. 이 파일은 VS Code 및 기타 MCP 호스트에서 원격 GitHub MCP 서버를 연결, 사용자 지정, 설치하는 방법에 대한 포괄적인 지침과 예시를 제공합니다.

도구 세트를 지정하지 않으면 기본 도구 세트가 사용됩니다.

Insiders 모드

새 기능을 일찍 사용해 보세요! 원격 서버는 새 기능과 실험적 도구에 대한 조기 액세스를 제공하는 insiders 버전을 제공합니다.

URL 경로 사용 헤더 사용

{
"servers" : {
"github" : {
"type" : " http " ,
"url" : " https://api.githubcopilot.com/mcp/insiders "
}
}
}

{
"servers" : {
"github" : {
"type" : " http " ,
"url" : " https://api.githubcopilot.com/mcp/ " ,
"headers" : {
"X-MCP-Insiders" : " true "
}
}
}
}

자세한 내용과 예시는 원격 서버 문서를, 사용 가능한 전체 목록은 Insiders 기능을 참조하세요.

GitHub Enterprise
데이터 레지던시가 있는 GitHub Enterprise Cloud (ghe.com)
GitHub Enterprise Cloud도 원격 서버를 활용할 수 있습니다.

GitHub PAT 토큰을 사용한 https://octocorp.ghe.com 예시:

{
...
"github-octocorp": {
"type": "http",
"url": "https://copilot-api.octocorp.ghe.com/mcp",
"headers": {
"Authorization": "Bearer ${input:github_mcp_pat}"
}
},
...
}

참고: VS Code 및 GitHub Copilot과 함께 GitHub Enterprise에서 OAuth를 사용하는 경우, VS Code 설정을 GitHub Enterprise 인스턴스를 가리키도록 구성해야 합니다 - VS Code에서 인증하기를 참조하세요

GitHub Enterprise Server
GitHub Enterprise Server는 원격 서버 호스팅을 지원하지 않습니다. 로컬 서버 구성의 GitHub Enterprise Server 및 데이터 레지던시가 있는 Enterprise Cloud (ghe.com)를 참조하세요.

로컬 GitHub MCP 서버

사전 요구 사항

컨테이너에서 서버를 실행하려면 Docker가 설치되어 있어야 합니다.

Docker가 설치되면 Docker가 실행 중인지도 확인해야 합니다. Docker 이미지는 ghcr.io/github/github-mcp-server 에서 사용할 수 있습니다. 이미지는 공개되어 있습니다. 풀 시 오류가 발생하면 토큰이 만료되었을 수 있으므로 docker logout ghcr.io 를 실행해야 합니다.

인증. github.com에서는 미리 아무것도 만들 필요가 없습니다 — 위의 원클릭 버튼이 첫 사용 시 OAuth로 로그인합니다 (브라우저 기반 흐름이며, 토큰은 메모리에만 보관됩니다). Docker 버튼은 고정 콜백 포트( 127.0.0.1:8085 )를 게시하여 컨테이너의 로그인 콜백에 접근할 수 있도록 합니다. 작동 방식, 헤드리스/디바이스 코드 대체 방법, 자체 OAuth 또는 GitHub App 사용(GitHub Enterprise Server 및 ghe.com에 필요)은 로컬 서버 OAuth 로그인을 참조하세요.

토큰을 선호하시나요? 대신 GITHUB_PERSONAL_ACCESS_TOKEN 을 설정하여 GitHub Personal Access Token으로 인증할 수 있습니다 (OAuth보다 우선합니다). MCP 서버는 많은 GitHub API를 사용할 수 있으므로, AI 도구에 부여해도 괜찮다고 생각하는 권한을 활성화하세요 (액세스 토큰에 대해 자세히 알아보려면 문서를 확인하세요).

PAT를 안전하게 처리하기
환경 변수 (권장)
GitHub PAT를 안전하게 유지하고 여러 MCP 호스트에서 재사용하려면:

PAT를 환경 변수에 저장

export GITHUB_PAT=your_token_here
또는 .env 파일 생성:

GITHUB_PAT = your_token_here

.env 파일 보호

# 실수로 커밋되는 것을 방지하기 위해 .gitignore에 추가
echo " .env " >> .gitignore

구성에서 토큰 참조

# CLI 사용
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN= $GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

# 구성 파일에서 (지원되는 경우)
" env " : {
" GITHUB_PERSONAL_ACCESS_TOKEN " : " $GITHUB_PAT "
}

참고 : 환경 변수 지원은 호스트 앱과 IDE에 따라 다릅니다. 일부 애플리케이션(예: Windsurf)은 구성 파일에 토큰을 하드코딩해야 합니다.

토큰 보안 모범 사례

최소 범위 : 필요한 권한만 부여

repo - 리포지토리 작업
read:packages - Docker 이미지 액세스
read:org - 조직 팀 액세스

토큰 분리 : 프로젝트/환경별로 다른 PAT 사용

정기적 교체 : 주기적으로 토큰 업데이트

절대 커밋하지 않기 : 토큰을 버전 관리에서 제외

파일 권한 : 토큰이 포함된 구성 파일에 대한 액세스 제한

chmod 600 ~ /.your-app/config.json

GitHub Enterprise Server 및 데이터 레지던시가 있는 Enterprise Cloud (ghe.com)
--gh-host 플래그와 GITHUB_HOST 환경 변수를 사용하여
GitHub Enterprise Server 또는 데이터 레지던시가 있는 GitHub Enterprise Cloud의
호스트 이름을 설정할 수 있습니다.

GitHub Enterprise Server의 경우 호스트 이름 앞에 https:// URI 스킴을 붙이세요. HTTPS가 필수이며 강제됩니다. HTTPS가 아닌 호스트는 거부되어 자격 증명이 평문으로 전송되지 않습니다 (유일한 예외는 로컬 개발을 위한 http://localhost 같은 루프백 호스트입니다).
데이터 레지던시가 있는 GitHub Enterprise Cloud의 경우 https://YOURSUBDOMAIN.ghe.com 을 호스트 이름으로 사용하세요.

"github" : {
"command" : " docker " ,
"args" : [
" run " ,
" -i " ,
" --rm " ,
" -e " ,
" GITHUB_PERSONAL_ACCESS_TOKEN " ,
" -e " ,
" GITHUB_HOST " ,
" ghcr.io/github/github-mcp-server "
],
"env" : {
"GITHUB_PERSONAL_ACCESS_TOKEN" : " ${input:github_token} " ,
"GITHUB_HOST" : " https://<your GHES or ghe.com domain name> "
}
}
설치
VS Code의 GitHub Copilot에 설치
빠른 설치를 위해 위의 원클릭 설치 버튼 중 하나를 사용하세요. 해당 흐름을 완료한 후 에이전트 모드(Copilot Chat 텍스트 입력 옆에 위치)를 켜면 서버가 시작됩니다.

VS Code의 에이전트 모드 문서에서 MCP 서버 도구 사용에 대해 자세히 알아보세요.

다른 IDE(JetBrains, Visual Studio, Eclipse 등)의 GitHub Copilot에 설치

IDE의 MCP 설정에 다음 JSON 블록 중 하나를 추가하세요.

OAuth로 로그인 (생성하거나 저장할 토큰 없음). github.com에서는 공식 이미지에 이미 앱 자격 증명이 포함되어 있으므로 직접 제공할 필요가 없습니다. 첫 사용 시 브라우저 기반 로그인을 실행하고 결과 토큰을 메모리에만 보관합니다 . Docker에서는 컨테이너의 로그인 콜백에 접근할 수 있도록 루프백에 게시된 고정 콜백 포트가 필요합니다:

{
"mcp" : {
"servers" : {
"github" : {
"command" : " docker " ,
"args" : [
" run " ,
" -i " ,
" --rm " ,
" -p " ,
" 127.0.0.1:8085:8085 " ,
" -e " ,
" GITHUB_OAUTH_CALLBACK_PORT " ,
" ghcr.io/github/github-mcp-server "
],
"env" : {
"GITHUB_OAUTH_CALLBACK_PORT" : " 8085 "
}
}
}
}
}
네이티브 바이너리 흐름(고정 포트 불필요), 헤드리스/디바이스 코드 대체 방법, GitHub Enterprise Server / ghe.com, 자체 OAuth 또는 GitHub App 사용은 로컬 서버 OAuth 로그인을 참조하세요.

비대화형 stdio 배포의 경우 GitHub App 인증을 참조하세요.

또는 Personal Access Token으로 인증하세요. 대신 GITHUB_PERSONAL_ACCESS_TOKEN 을 설정하세요 (OAuth보다 우선합니다):

{
"mcp" : {
"inputs" : [
{
"type" : " promptString " ,
"id" : " github_token " ,
"description" : " GitHub Personal Access Token " ,
"password" : true
}
],
"servers" : {
"github" : {
"command" : " docker " ,
"args" : [
" run " ,
" -i " ,
" --rm " ,
" -e " ,
" GITHUB_PERSONAL_ACCESS_TOKEN " ,
" ghcr.io/github/github-mcp-server "
],
"env" : {
"GITHUB_PERSONAL_ACCESS_TOKEN" : " ${input:github_token} "
}
}
}
}
}
선택적으로, 워크스페이스의 .vscode/mcp.json 이라는 파일에 유사한 예시(mcp 키가 없는)를 추가할 수 있습니다. 이렇게 하면 동일한 형식을 허용하는 다른 호스트 애플리케이션과 구성을 공유할 수 있습니다.

MCP 키가 포함되지 않은 예시 JSON 블록

{
"inputs" : [
{
"type" : " promptString " ,
"id" : " github_token " ,
"description" : " GitHub Personal Access Token " ,
"password" : true
}
],
"servers" : {
"github" : {
"command" : " docker " ,
"args" : [
" run " ,
" -i " ,
" --rm " ,
" -e " ,
" GITHUB_PERSONAL_ACCESS_TOKEN " ,
" ghcr.io/github/github-mcp-server "
],
"env" : {
"GITHUB_PERSONAL_ACCESS_TOKEN" : " ${input:github_token} "
}
}
}
}

다른 MCP 호스트에 설치
다른 MCP 호스트 애플리케이션의 경우 설치 가이드를 참조하세요:

Copilot CLI - 설치 …