gemini cli로 mcp사용하기(github 자동화)

Gemini CLI와 GitHub 연동하기 (MCP 서버 설정 가이드)

 

Gemini CLI는 외부 도구와 연동할 수 있는 MCP(Model-Context-Protocol)를 지원합니다. 이 글에서는 GitHub와 연동하는 MCP를 설치하고, 이를 통해 간단한 Git 명령을 실행하는 방법을 알아보겠습니다.

 

---

 

1. Gemini CLI 설치하기

 

가장 먼저 Gemini CLI가 설치되어 있어야 합니다. 설치 방법에 대해서는 아래 두 링크중 하나를 참고해주세요.

 

2025.06.30 - [AI] - gemini api로 gemini cli사용법

gemini api로 gemini cli사용법

2025.06.27 - [AI] - google gemini cli 사용하기

google gemini cli 사용하기

 

2. GitHub Personal Access Token(PAT) 준비

 

 

 

GitHub 웹사이트에서 Settings > Developer settings > Personal access tokens로 이동하고, 토큰(PAT)을 생성한 뒤 복사해 두세요.

 

3. .gemini/settings.json에 GitHub MCP 서버 등록

 

New-Item -ItemType Directory -Path .gemini
New-Item -ItemType File -Path .gemini\settings.json

먼저 위 명령어를 터미널에 입력해주세요. 폴더를 생성하고, json파일을 생성하는 코드입니다.

 

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "여기에_복사한_PAT를_붙여넣기"
      }
    }
  }
}

생성된 settings.json 파일에 들어가서, 위 코드를 json에 붙여넣습니다. 이렇게 하면, "mcpServers"에 github mcp를 추가할 수 있습니다.

앞서 복사한 GITHUB_PERSONAL_ACCESS_TOKEN을 env의 값에 입력하세요.

 

4. Gemini CLI 재시작 및 MCP 서버 확인

 

 

터미널에서 `gemini`를 입력하여 CLI를 재시작한 후, `/mcp` 명령을 입력하면 등록된 mcp 목록을 확인할 수 있습니다. `github`가 보이면 성공입니다.

 

5. 간단한 동작 시연

 

 

이제 모든 준비가 끝났습니다. Gemini CLI에게 예를 들어 "`(레포지토리 주소)`를 pull 해줘"라고 요청하면, Gemini가 MCP를 통해 git pull 명령을 실행해 줍니다.