GitHub MCP Server

GitHub 공식 MCP 서버, 원격 엔드포인트 제공

docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

GitHub 가 직접 운영하는 MCP 서버입니다. 저장소와 이슈, 풀 리퀘스트, 액션을 에이전트가 다루게 해 줍니다. 설치 없이 붙는 원격 엔드포인트와 직접 띄우는 Docker 이미지 두 경로를 모두 제공합니다.

판단

이럴 때 씁니다

  • 에이전트가 이슈와 풀 리퀘스트를 직접 읽고 쓰게 하고 싶을 때
  • 설치 없이 원격 엔드포인트만으로 GitHub 연동을 끝내고 싶을 때
  • 조직 단위 규칙셋이나 커스텀 속성을 에이전트가 조회하게 해야 할 때
  • 여러 MCP 호스트에서 같은 GitHub 연동을 공유하고 싶을 때

이럴 땐 쓰지 마세요

  • GitHub 외의 코드 호스팅을 쓰는 경우
  • 쓰기 권한을 에이전트에 주기 어려운 보안 정책이 있는 경우
  • 로컬 저장소 파일만 다루면 충분한 작업일 때

차별점

  • GitHub 가 직접 만들고 운영하는 공식 서버입니다.
  • 설치형과 호스팅 원격 엔드포인트 두 경로를 모두 제공합니다.
  • 저장소 규칙셋과 커스텀 속성 같은 조직 거버넌스 영역까지 도구로 엽니다.
  • Go 단일 바이너리라 컨테이너 배포가 가볍습니다.

워크플로

  1. 01원격 엔드포인트를 쓰려면 클라이언트에 http 타입으로 https://api.githubcopilot.com/mcp/ 를 등록합니다.
  2. 02직접 띄우려면 개인 액세스 토큰을 환경 변수로 넘겨 Docker 이미지를 실행합니다.
  3. 03필요한 도구 집합만 켜서 세션 시작 시 소모하는 토큰을 줄입니다.
  4. 04쓰기 작업은 권한을 좁힌 토큰으로 분리해 두는 편이 안전합니다.

주요 명령

명령설명
docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server로컬에서 서버를 실행합니다.
https://api.githubcopilot.com/mcp/설치 없이 붙는 원격 엔드포인트 주소입니다.

함정

설치 전에 확인하세요

  • 원격 엔드포인트는 OAuth 를 지원하는 호스트가 필요합니다. VS Code 는 1.101 이상을 요구합니다.
  • MCP 서버는 세션 시작 때 도구 스키마를 통째로 보냅니다. 도구가 많은 서버를 여럿 켜면 컨텍스트를 크게 잡아먹습니다.
  • 공개 저장소 기여용 도구는 public_repo 범위만으로 동작합니다. 토큰 권한을 필요 이상으로 넓히지 않는 편이 좋습니다.

비교

직접 만든 얇은 래퍼로도 이슈 조회 정도는 됩니다. 다만 페이지네이션과 권한 처리, 마크다운 본문의 안전한 필터링처럼 지루한 부분에서 차이가 벌어집니다. 공식 서버는 그 부분을 이미 겪은 상태이고, 원격 엔드포인트가 있어 팀에 배포할 때 설치 안내가 필요 없습니다.

최근 변경

v1.12.0 에서 저장소와 조직, 엔터프라이즈 수준의 규칙셋과 커스텀 속성을 읽고 관리하는 도구를 추가했습니다. 쓰기 작업 쪽은 병합 시 예상 HEAD SHA 를 고정하는 옵션과 파일 SHA 회수 경로를 넣어 안전성을 높였고, 라벨이 조용히 누락되던 문제를 고쳤습니다. 마크다운 본문과 릴리스 노트는 위험한 입력만 걸러내고 보이는 내용은 보존하도록 바꿨습니다.

공식 변경 내역