본문으로 건너뛰기
MCP 서버 전체 목록

GitHub MCP Server

  • 추천0
  • GitHub 별35K
  • 개발원격 연결라이선스MIT

GitHub 공식 MCP 서버. 에이전트가 저장소 · 코드 · 이슈 · PR · Actions를 읽고 다뤄요(원격 · 로컬 Docker)

원본:github/github-mcp-server

연결 · 설치 방법은 설치 탭에 정리했어요.

설명

Go Report Card

GitHub MCP Server

GitHub MCP Server는 AI 도구를 GitHub 플랫폼에 바로 연결해 줍니다. AI 에이전트, 어시스턴트, 챗봇이 저장소와 코드 파일을 읽고, 이슈와 PR을 관리하고, 코드를 분석하고, 워크플로를 자동화할 수 있습니다. 모두 자연어 대화로 이루어집니다.

이런 데 씁니다

  • 저장소 관리: 접근 권한이 있는 어떤 저장소든 코드를 둘러보고 검색하고, 커밋을 분석하고, 프로젝트 구조를 파악합니다.
  • 이슈 · PR 자동화: 이슈와 풀 리퀘스트를 만들고 고치고 관리합니다. 버그 분류, 코드 변경 리뷰, 프로젝트 보드 정리를 AI가 도와줍니다.
  • CI/CD · 워크플로 분석: GitHub Actions 실행을 지켜보고, 빌드 실패를 분석하고, 릴리스를 관리하고, 개발 파이프라인의 상태를 살핍니다.
  • 코드 분석: 보안 발견 사항과 Dependabot 경고를 살펴보고, 코드 패턴을 이해하고, 코드베이스 전반의 통찰을 얻습니다.
  • 팀 협업: 디스커션에 접근하고, 알림을 관리하고, 팀 활동을 분석하고, 팀의 업무 절차를 간소화합니다.

간단한 자연어 질문부터 여러 단계를 거치는 복잡한 에이전트 워크플로까지, AI 도구를 GitHub의 맥락과 기능에 연결하려는 개발자를 위해 만들었습니다.

Go 모듈로 쓰기

Go 모듈 경로는 github.com/github/github-mcp-server/v2입니다. 라이브러리로 가져다 쓸 때는 import와 go get 명령에 이 접두사를 붙여야 합니다. 예를 들어 github.com/github/github-mcp-server/v2/pkg/github처럼 씁니다. 저장소를 체크아웃해서 빌드할 때는 /v2 하위 디렉터리가 필요 없습니다.

기존 v2.0.0 태그는 모듈 경로를 바로잡기 전에 만들어져 Go 모듈로는 쓸 수 없습니다. 바로잡은 경로가 들어 있는 커밋에서 v2.0.1 같은 새 릴리스를 태그해야 하고, 그때까지는 이 변경이 들어간 커밋의 의사 버전(pseudo-version)을 쓸 수 있습니다.


원격 GitHub MCP Server

VS Code에 설치 VS Code Insiders에 설치 Visual Studio에 설치

원격 GitHub MCP Server는 GitHub가 직접 호스팅하며, 가장 쉽게 시작하는 방법입니다. 쓰는 MCP 호스트가 원격 MCP 서버를 지원하지 않아도 걱정하지 마세요. 그때는 로컬 GitHub MCP Server를 쓰면 됩니다.

준비물

  1. 원격 서버를 지원하는 MCP 호스트 (VS Code 1.101 이상, Claude Desktop, Cursor, Windsurf 등)
  2. 필요한 정책 활성화

VS Code에 설치

빠르게 설치하려면 위의 원클릭 설치 버튼 중 하나를 쓰세요. 설치가 끝나면 Copilot Chat 입력창 옆의 에이전트 모드를 켜면 서버가 시작됩니다. 원격 MCP와 OAuth를 쓰려면 VS Code 1.101 이상(최신 버전)이어야 합니다.

직접 설정하려면 아래 예시에서 알맞은 JSON을 골라 호스트 설정에 추가하세요. (VS Code 1.101 이상)

OAuth 사용

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

GitHub PAT 사용

{
  "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 호스트에 설치

참고: 각 MCP 호스트 앱은 OAuth로 원격 접속을 지원하려면 GitHub App이나 OAuth App을 따로 설정해야 합니다. 원격 MCP 서버를 지원하는 호스트라면 PAT 인증으로는 원격 GitHub 서버를 쓸 수 있습니다. 설정 방법과 지원 수준은 호스트마다 다르니 해당 호스트 앱의 문서를 확인하세요.

설정

툴셋 설정

원격 서버 설정, 툴셋, 헤더, 고급 사용법은 원격 서버 문서에 자세히 나와 있습니다. VS Code와 다른 MCP 호스트에서 원격 GitHub MCP Server를 연결하고 맞춤 설정하고 설치하는 안내와 예시가 모두 들어 있습니다.

툴셋을 따로 지정하지 않으면 기본 툴셋이 쓰입니다.

인사이더 모드

새 기능을 먼저 써 보세요! 원격 서버는 새 기능과 실험적인 도구를 먼저 쓸 수 있는 인사이더 버전을 제공합니다.

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"
      }
    }
  }
}

자세한 내용과 예시는 원격 서버 문서의 인사이더 모드를, 쓸 수 있는 기능 전체 목록은 인사이더 기능을 보세요.

GitHub Enterprise

데이터 거주(ghe.com)를 쓰는 GitHub Enterprise Cloud

GitHub Enterprise Cloud에서도 원격 서버를 쓸 수 있습니다.

https://octocorp.ghe.com에 GitHub PAT를 쓰는 예시입니다.

{
    ...
    "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와 데이터 거주(ghe.com)를 쓰는 Enterprise Cloud」를 보세요.


로컬 GitHub MCP Server

VS Code에 Docker로 설치 VS Code Insiders에 Docker로 설치 Visual Studio에 Docker로 설치

준비물

  1. 서버를 컨테이너로 돌리려면 Docker가 설치되어 있어야 합니다.
  2. Docker를 설치한 뒤에는 Docker가 실행 중인지도 확인하세요. Docker 이미지는 ghcr.io/github/github-mcp-server에 있습니다. 이미지는 공개되어 있고, 받을 때 오류가 나면 토큰이 만료된 것일 수 있으니 docker logout ghcr.io를 해 보세요.
  3. 인증. github.com에서는 미리 만들어 둘 것이 없습니다. 위의 원클릭 버튼으로 설치하면 처음 쓸 때 OAuth(브라우저 기반 로그인)로 로그인하고, 토큰은 메모리에만 보관됩니다. Docker 버튼은 컨테이너의 로그인 콜백이 닿도록 고정 콜백 포트(127.0.0.1:8085)를 열어 줍니다. 동작 방식, 화면이 없는 환경의 기기 코드 대체 로그인, 직접 만든 OAuth 또는 GitHub App 쓰기(GitHub Enterprise Server와 ghe.com에서는 필수)는 로컬 서버 OAuth 로그인 을 보세요.

토큰을 쓰고 싶다면 GITHUB_PERSONAL_ACCESS_TOKEN을 설정해 GitHub 개인 액세스 토큰으로 인증할 수도 있습니다. 이 값이 있으면 OAuth보다 우선합니다. MCP 서버는 GitHub의 여러 API를 쓸 수 있으니, AI 도구에 줘도 괜찮다고 생각하는 권한만 켜세요. 액세스 토큰에 대해서는 문서를 참고하세요.

PAT를 안전하게 다루기

환경 변수 사용 (권장)

GitHub PAT를 안전하게 두고 여러 MCP 호스트에서 재사용하는 방법입니다.

  1. PAT를 환경 변수에 저장합니다

    export GITHUB_PAT=your_token_here

    또는 .env 파일을 만듭니다.

    GITHUB_PAT=your_token_here
    
  2. .env 파일을 보호합니다

    # 실수로 커밋하지 않도록 .gitignore에 추가
    echo ".env" >> .gitignore
  3. 설정에서 토큰을 참조합니다

    # 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와 데이터 거주(ghe.com)를 쓰는 Enterprise Cloud

--gh-host 플래그와 GITHUB_HOST 환경 변수로 GitHub Enterprise Server나 데이터 거주를 쓰는 GitHub Enterprise Cloud의 호스트 이름을 지정합니다.

  • GitHub Enterprise Server는 호스트 이름 앞에 https://를 붙입니다. 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 인증 을 보세요.

아니면 개인 액세스 토큰(PAT)으로 인증합니다. 대신 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 호스트 애플리케이션은 아래 설치 안내를 보세요.

모든 설치 방법은 설치 안내 목차 에서 볼 수 있습니다.

참고: 로컬 MCP 서버를 지원하는 호스트 애플리케이션이라면 로컬 GitHub MCP 서버에 접근할 수 있어야 합니다. 다만 구체적인 설정 과정, 문법, 연동의 안정성은 호스트마다 다릅니다. 위 예시와 비슷한 형식인 경우가 많지만 보장되지는 않습니다. 정확한 MCP 설정 문법과 절차는 쓰는 호스트 애플리케이션의 문서를 확인하세요.

소스에서 빌드

Docker가 없다면 go build로 cmd/github-mcp-server 디렉터리에서 바이너리를 만들고, GITHUB_PERSONAL_ACCESS_TOKEN 환경 변수를 설정한 채 github-mcp-server stdio 명령을 쓰면 됩니다. 출력 위치는 -o 플래그로 지정합니다. 만든 실행 파일을 서버의 command로 설정하세요.

STDIO API 요청은 서버를 github-mcp-server/<version> 형태로 알리고, 가능하면 업스트림 MCP 클라이언트의 이름과 버전을 괄호 안에 남깁니다. 클라이언트 메타데이터의 제어 문자, 따옴표, 역슬래시, 괄호는 HTTP 헤더가 깨지지 않도록 이스케이프하고, 일반 이름과 버전, 공백, 출력 가능한 유니코드는 그대로 둡니다. 릴리스 빌드는 릴리스 버전을 유지하고, 리비전 정보가 있는 소스 빌드와 기본 Docker 빌드는 vcs-<revision>을 씁니다. 이것은 릴리스 번호가 아니라 VCS 빌드 식별자입니다.

Git 체크아웃에서 go build -o github-mcp-server ./cmd/github-mcp-server로 전체 패키지를 빌드하면 VCS 리비전이 들어갑니다. VCS 메타데이터가 없는 빌드는 실제 릴리스를 -ldflags '-X main.version=<version>'으로, 전체 소스 리비전을 -ldflags '-X main.commit=<commit>'으로 넘기세요. 쓸 메타데이터는 명시한 릴리스, 명시한 소스 리비전, 내장 VCS 리비전, 설치된 메인 모듈 버전 순으로 고릅니다. 쓸 수 있는 값이 하나도 없으면 STDIO는 개발용 표시 dev로 시작하고 stderr에 경고를 냅니다. stdout은 MCP 프로토콜용으로 비워 둡니다. 버전별 출처 표기가 필요하면 실제 릴리스나 리비전 메타데이터를 넘기세요.

예시:

{
  "mcp": {
    "servers": {
      "github": {
        "command": "/path/to/github-mcp-server",
        "args": ["stdio"],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
        }
      }
    }
  }
}

도구 설정

GitHub MCP Server는 --toolsets 플래그로 기능 묶음을 켜거나 끌 수 있습니다. AI 도구가 쓸 수 있는 GitHub API 기능을 직접 정하는 방식입니다. 필요한 툴셋만 켜 두면 LLM이 도구를 고르기 쉬워지고 컨텍스트 크기도 줄어듭니다.

툴셋은 도구(Tool)만 묶는 것이 아닙니다. 관련 MCP 리소스와 프롬프트도 해당하는 곳에 함께 들어 있습니다.

툴셋을 따로 지정하지 않으면 기본 툴셋이 쓰입니다.

예시가 필요하신가요? 최소 구성, 읽기 전용 모드, 도구와 툴셋 조합 같은 자주 쓰는 방법은 서버 설정 가이드를 보세요.

툴셋 지정

LLM이 쓸 툴셋을 허용 목록으로 지정하는 방법은 두 가지입니다.

  1. 명령줄 인자로:

    github-mcp-server --toolsets repos,issues,pull_requests,actions,code_security
  2. 환경 변수로:

    GITHUB_TOOLSETS="repos,issues,pull_requests,actions,code_security" ./github-mcp-server

둘 다 주면 환경 변수 GITHUB_TOOLSETS가 명령줄 인자보다 우선합니다.

개별 도구 지정

--tools 플래그로 특정 도구만 골라 켤 수도 있습니다. 도구는 따로 쓰거나 툴셋과 함께 써서 세밀하게 제어할 수 있습니다.

  1. 명령줄 인자로:

    github-mcp-server --tools get_file_contents,issue_read,create_pull_request
  2. 환경 변수로:

    GITHUB_TOOLS="get_file_contents,issue_read,create_pull_request" ./github-mcp-server
  3. 툴셋과 함께 쓰기 (더해집니다):

    github-mcp-server --toolsets repos,issues --tools get_gist

    repos와 issues 툴셋의 모든 도구에 get_gist가 더해져 등록됩니다.

알아 둘 점:

  • 도구와 툴셋은 함께 쓸 수 있습니다.
  • 읽기 전용 모드가 우선합니다. --read-only를 주면 --tools로 직접 요청한 쓰기 도구도 등록되지 않습니다.
  • 도구 이름은 정확히 맞아야 합니다(getFileContents가 아니라 get_file_contents). 잘못된 이름을 주면 서버가 오류 메시지와 함께 시작에 실패합니다.
  • 도구 이름이 바뀌어도 옛 이름은 호환용 별칭으로 남습니다. 자세한 내용은 도구 이름 변경을 보세요.

Docker와 함께 툴셋 쓰기

Docker에서는 툴셋을 환경 변수로 넘깁니다.

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_TOOLSETS="repos,issues,pull_requests,actions,code_security" \
  ghcr.io/github/github-mcp-server

Docker와 함께 도구 쓰기

Docker에서는 특정 도구도 환경 변수로 넘길 수 있고, 툴셋과 함께 쓸 수도 있습니다.

# 도구만
docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_TOOLS="get_file_contents,issue_read,create_pull_request" \
  ghcr.io/github/github-mcp-server

# 도구와 툴셋을 함께 (더해집니다)
docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_TOOLSETS="repos,issues" \
  -e GITHUB_TOOLS="get_gist" \
  ghcr.io/github/github-mcp-server

특별 툴셋

"all" 툴셋

특별 툴셋 all을 주면 다른 설정과 상관없이 사용 가능한 모든 툴셋을 켭니다.

./github-mcp-server --toolsets all

환경 변수로도 됩니다.

GITHUB_TOOLSETS="all" ./github-mcp-server

"default" 툴셋

툴셋을 지정하지 않으면 서버에 default 툴셋이 넘어갑니다.

기본 구성은 다음과 같습니다.

  • context
  • repos
  • issues
  • pull_requests
  • users

기본 구성을 유지하면서 툴셋을 더하려면 이렇게 합니다.

GITHUB_TOOLSETS="default,stargazers" ./github-mcp-server

인사이더 모드

로컬 GitHub MCP Server도 새 기능과 실험적인 도구를 먼저 쓸 수 있는 인사이더 버전이 있습니다.

  1. 명령줄 인자로:

    ./github-mcp-server --insiders
  2. 환경 변수로:

    GITHUB_INSIDERS=true ./github-mcp-server

Docker에서는 이렇게 합니다.

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_INSIDERS=true \
  ghcr.io/github/github-mcp-server

사용 가능한 툴셋

아래 도구 묶음을 쓸 수 있습니다.

툴셋설명
personcontext강력히 권장: 현재 사용자와 작업 중인 GitHub 맥락을 알려 주는 도구
workflowactionsGitHub Actions 워크플로와 CI/CD 작업
code-squarecode_qualityGitHub Code Quality 관련 도구
codescancode_securityGitHub 코드 스캐닝 같은 코드 보안 관련 도구
copilotcopilotCopilot 관련 도구
copilotcopilot_issue_intents의도 메타데이터(근거, 확신도, 제안)를 함께 보내는 Copilot 이슈 할당 도구 (직접 켜야 함)
dependabotdependabotDependabot 도구
comment-discussiondiscussionsGitHub Discussions 관련 도구
logo-gistgistsGitHub Gist 관련 도구
git-branchgit저수준 Git 작업을 위한 GitHub Git API 도구
lawgovernance저장소·조직·엔터프라이즈 수준의 룰셋과 사용자 지정 속성을 관리하는 저장소 거버넌스 도구
issue-openedissuesGitHub Issues 관련 도구
taglabelsGitHub 레이블 관련 도구
bellnotificationsGitHub 알림 관련 도구
organizationorgsGitHub 조직 관련 도구
projectprojectsGitHub Projects 관련 도구
git-pull-requestpull_requestsGitHub 풀 리퀘스트 관련 도구
reporeposGitHub 저장소 관련 도구
shield-locksecret_protectionGitHub 시크릿 스캐닝 같은 시크릿 보호 관련 도구
shieldsecurity_advisories보안 권고 관련 도구
starstargazersGitHub 스타 관련 도구
peopleusersGitHub 사용자 관련 도구

원격 GitHub MCP Server의 추가 툴셋

툴셋설명
copilotCopilot 관련 도구 (예: Copilot 코딩 에이전트)
copilot_spacesCopilot Spaces 관련 도구
github_support_docs_searchGitHub 제품·지원 질문에 답하도록 문서를 검색

MCP 스킬

로컬 서버에는 워크플로 스킬이 들어 있습니다. --features=skills(또는 인사이더 모드)로 켜면 서버 지침을 대신합니다. 스킬은 기본으로 꺼져 있고 연결에서 쓸 수 있는 도구에 맞춰 걸러지므로, 툴셋을 좁히면 일부 스킬만 보일 수 있습니다.

  • account-and-team-context: 인증된 계정이 누구이고 어떤 조직·팀에 속하는지, 팀에 누가 있는지, 저장소에 쓰기 권한이 누구에게 있는지 파악합니다.
  • codebase-exploration: 낯선 저장소의 구조, 동작이 구현된 곳, 특정 함수나 줄이 언제 왜 바뀌었는지 이해합니다.
  • copilot-task-delegation: 작업을 Copilot 코딩 에이전트에게 넘깁니다. 이슈가 위임할 만큼 범위가 좁은지 판단하고, 실행하고, 변경에 대한 자동 1차 리뷰를 요청합니다.
  • discussion-participation: GitHub Discussions에 참여합니다. 카테고리의 답 없는 질문을 찾고, 스레드를 끝까지 읽고, 답글을 달고, 문제를 해결한 답에 표시합니다.
  • issue-authoring: 명확한 버그 리포트나 기능 요청 하나를 올립니다. 이미 보고됐는지 확인하고, 유형과 필드를 고르고, 하위 이슈로 나누고, 바로 실행할 수 있는 제목과 본문을 씁니다.
  • issue-backlog-triage: 열린 이슈 백로그를 분류합니다. 실행할 수 있는 것을 가리고, 레이블과 유형을 붙이고, 중복과 상위 이슈를 연결하고, 의미가 끝난 것을 닫습니다.
  • label-scheme-management: 저장소의 레이블 체계를 가꿉니다. 없는 레이블을 추가하고, 실제로 쓰이는 것을 점검하고, 이름과 색을 바꾸고, 겹치는 것을 합치고, 안 쓰는 것을 정리합니다.
  • notification-triage: 알림함을 처리합니다. 답해야 할 것, 구독을 끊을 것, 읽음·완료로 표시할 것을 가립니다.
  • project-planning: GitHub Projects 보드에서 작업을 계획하고 갱신합니다. 필드와 보기를 읽고, 이슈나 PR을 항목으로 추가하고, 상태와 이터레이션을 정하고, 상태 업데이트를 올립니다.
  • pull-request-authoring: 브랜치의 작업을 병합까지 끌고 갑니다. PR을 열고, 설명하고, 리뷰어를 요청하고, 기준 브랜치와 맞춰 두고, 검사와 승인이 끝나면 병합합니다.
  • pull-request-code-review: 다른 사람의 PR을 살펴보고 결론을 냅니다. 맥락 속에서 diff를 읽고, 줄에 붙은 코멘트를 한꺼번에 남기고, 승인하거나 변경을 요청합니다.
  • pull-request-review-feedback: PR에 달린 리뷰 의견을 처리합니다. 해결되지 않은 스레드를 읽고, 무엇을 바꿀지 정하고, 리뷰어에게 답하고, 스레드를 해결 처리합니다.
  • release-preparation: 저장소 릴리스를 만듭니다. 버전을 고르고, 마지막 태그 이후의 변경 내역을 모으고, 브랜치가 릴리스할 수 있는 상태인지 확인하고, 릴리스 노트를 씁니다.
  • repository-content-changes: 저장소의 내용이나 존재 자체를 바꿉니다. 작업 브랜치를 열고, 파일을 원격으로 커밋하고, 지울 것을 지우고, 저장소를 만들거나 포크하거나 삭제합니다.
  • repository-discovery: 이름을 모르는 라이브러리, 도구, 조직을 찾고, 후보 프로젝트가 의존할 만한지 판단하고, 스타로 모은 목록을 쓸모 있게 유지합니다.
  • repository-health-review: 저장소가 얼마나 잘 관리되는지 종합 판단합니다. 릴리스 주기, 브랜치와 제안의 나이, 이슈 유입, 빌드 안정성, 유지보수할 수 있는 사람 수, 남은 경고 수를 봅니다.
  • security-alert-triage: 코드 스캐닝, Dependabot, 시크릿 스캐닝, 보안 권고 경고를 조사해 지금 고칠지, 일정에 넣을지, 기각할지, 상위에 올릴지 정합니다.
  • workflow-failure-triage: 실패한 GitHub Actions 실행을 진단합니다. 빨갛게 된 빌드, 실패한 작업, 로그 내용, 실패한 단계 위치, 다시 실행할 만한지 판단합니다.

더 알아보기

  • 도구 목록: 툴셋마다 쓸 수 있는 도구(예: Actions 툴셋의 actions_get · actions_list · actions_run_trigger)와 매개변수는 원문 README의 Tools 절에 툴셋별로 정리되어 있습니다. 지원하는 MCP 프로토콜 버전(2026-07-28 이상)에서는 저장소 · 이슈 · Actions 도구가 구조화된 결과(structuredContent)를 돌려줍니다.
  • 원격 서버 · 정책 · 거버넌스: 원격 서버 문서, 정책과 거버넌스
  • 저장소와 라이선스: github/github-mcp-server