GitHub

officialgithubremote

GitHub이 직접 만들고 관리하는 공식 MCP 서버다. Claude가 GitHub API를 통해 리포지토리 관리, 이슈/PR 처리, 코드 탐색, CI/CD 모니터링 등을 수행할 수 있게 된다. 2025년 4월부터 기존 npm 패키지(@modelcontextprotocol/server-github)는 지원 종료되었다. Docker, 사전 빌드된 바이너리, 또는 GitHub가 호스팅하는 Remote MCP 서버를 사용해야 한다. 단, Claude Code 환경에서는 gh CLI가 이미 같은 역할을 더 가볍게 수행할 수 있다.

무엇을 할 수 있나

이슈 읽기 / 쓰기

이슈를 조회하고 새로 만들거나 댓글을 달고 상태를 바꾼다.

PR 생성 / 관리

Pull Request를 열고, 리뷰 댓글을 달고, 머지한다.

코드 검색

GitHub 전체 또는 특정 리포지토리에서 코드를 검색한다.

파일 읽기 / 쓰기

리포지토리 내 파일을 읽거나 커밋과 함께 수정한다. 로컬 클론 없이도 GitHub 상의 파일을 직접 편집할 수 있다.

GitHub Actions 모니터링

워크플로우 실행 상태를 조회하고 빌드 실패를 분석한다.

브랜치 / 태그 / 릴리즈 관리

브랜치를 만들고 태그와 릴리즈를 관리한다.

보안 스캔 / Dependabot

코드 보안 알림을 검토하고 Dependabot PR을 관리한다.

Claude Desktop — Remote MCP (설치 불필요)

GitHub이 호스팅하는 Remote MCP 서버로 연결한다. 로컬 설치 없이 OAuth 또는 PAT로 인증한다. GITHUB_PERSONAL_ACCESS_TOKEN을 먼저 환경 변수로 설정해두세요.

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:github_mcp_pat}"
      }
    }
  }
}

github.com/settings/tokens 에서 PAT를 발급하세요. 필요 스코프: repo, read:org, read:packages

Claude Desktop — Docker (로컬 실행)

Docker로 GitHub MCP를 로컬에서 실행한다. Docker가 설치되어 있어야 한다. GITHUB_PERSONAL_ACCESS_TOKEN은 env 필드에 직접 입력하거나, 환경 변수를 미리 설정하고 참조하세요.

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

docker.com/get-started 에서 Docker를 먼저 설치하세요.

Claude Code

PAT를 먼저 환경 변수로 export한 뒤 아래 명령어를 실행한다. 토큰을 커맨드에 직접 입력하면 shell history에 남으므로, $변수 참조 방식을 권장한다.

export GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PERSONAL_ACCESS_TOKEN -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

기본값은 현재 프로젝트에만 등록(local). 모든 프로젝트에서 쓰려면 --scope user를 추가하세요.

대안 — GitHub CLI (gh)

Claude Code 환경에서는 MCP 대신 gh CLI를 쓰는 경우가 많다. gh가 설치되어 있고 로그인된 상태라면, Claude Code는 Bash를 통해 gh 명령어를 직접 실행할 수 있다. Docker나 PAT 설정 없이도 동일한 작업 대부분을 처리할 수 있어 Claude Code 사용자에게는 더 가벼운 선택지다. Claude Desktop에서는 Bash 접근이 없으므로 gh CLI를 활용할 수 없다. MCP를 사용해야 한다.

macOS — Homebrew로 설치한다.

brew install gh

로그인 — 설치 후 GitHub 계정으로 인증한다. 브라우저가 열리며 OAuth 인증이 진행된다.

gh auth login

GitHub ↗