IT 관련/AI

Windows PC에서 Gemini CLI와 MCP 서버 설치

islet2 2025. 6. 27. 15:57

Windows PC에서 Gemini CLI와 MCP 서버 설치  
- 초보자를 위한 완벽 가이드 -  BY GEMINI Deep Research

 

이 자료는 Windows PC 사용자를 위해 Google의 강력한 AI 에이전트인 Gemini Command Line Interface (CLI)를 설치하고, 로컬 컴퓨터의 파일 시스템에 접근하여 파일을 관리할 수 있도록 설정하는 모든 과정을 상세하게 안내합니다. 나아가 Gemini CLI의 능력을 극대화할 수 있는 추가 기능(MCP 서버)을 발견하고 설치하는 방법까지, 초보자의 눈높이에 맞춰 차근차근 설명합니다. 이 가이드를 마치면 여러분의 터미널은 단순한 명령어 입력 창이 아닌, 지능적인 AI 비서로 거듭날 것입니다.

1부: 첫걸음 - Gemini CLI를 위한 Windows 환경 준비

Gemini CLI를 설치하기 전에, 우리 컴퓨터에 몇 가지 기본적인 준비가 필요합니다. 가장 중요한 것은 'Node.js'라는 프로그램을 설치하는 것입니다. 이 과정은 마치 새로운 가전제품을 사용하기 전에 전원을 연결하는 것처럼 필수적인 단계입니다.

1.1 Node.js란 무엇이며 왜 필요한가요?

Gemini CLI는 '자바스크립트(JavaScript)'라는 프로그래밍 언어 기술을 기반으로 만들어진 정교한 프로그램입니다. 일반적으로 자바스크립트는 웹 브라우저 안에서 웹사이트를 동적으로 만드는 데 사용되지만, 'Node.js'는 이 자바스크립트가 웹 브라우저 바깥, 즉 우리 컴퓨터의 일반적인 환경에서도 작동할 수 있게 해주는 "실행 환경(Runtime Environment)"입니다.  

 

조금 더 쉬운 비유를 들어보겠습니다. 자동차가 움직이려면 '엔진'이 필요한 것처럼, Gemini CLI와 같은 자바스크립트 기반 도구가 우리 컴퓨터에서 원활하게 작동하려면 'Node.js'라는 엔진이 반드시 필요합니다.  

 

또한, Node.js를 설치하면 'npm(Node Package Manager)'이라는 매우 유용한 도구가 함께 설치됩니다. npm은 이름 그대로 Node.js로 만들어진 수많은 패키지(프로그램)들을 관리하는 도구이며, 우리는 바로 이 npm을 사용해 Gemini CLI를 매우 간단하게 다운로드하고 설치하게 될 것입니다.  

 

1.2 단계별 가이드: Windows에 Node.js 설치하기

Node.js 설치는 매우 간단하며, 몇 번의 클릭만으로 완료할 수 있습니다.

  1. Node.js 공식 웹사이트 방문: 웹 브라우저를 열고 https://nodejs.org 주소로 이동합니다.  
  2. LTS 버전 다운로드: 웹사이트에 접속하면 두 가지 버전이 보일 것입니다.
    • LTS (Long-Term Support): 장기적으로 안정적인 지원이 보장되는 버전입니다. 대부분의 사용자에게 권장되며, 특히 처음 시작하는 분들에게는 안정성과 호환성이 검증된 이 버전을 강력히 추천합니다.  
    • Current: 최신 기능이 포함되어 있지만, 안정성이 완전히 검증되지 않았을 수 있습니다.
    LTS라고 표시된 버튼을 클릭하여 설치 파일(.msi 형식)을 다운로드합니다.
  3. 설치 프로그램 실행: 다운로드한 .msi 파일을 더블 클릭하여 설치 마법사를 시작합니다.
    • 대부분의 과정은 'Next' 버튼을 누르기만 하면 됩니다.  
    • 설치 경로를 묻는 화면이 나오면, 특별한 이유가 없다면 기본 경로(C:\Program Files\nodejs\)를 그대로 사용하는 것이 좋습니다. 나중에 문제가 발생했을 때 해결하기가 더 쉽습니다.  
    • 설치 옵션 중 "Automatically install the necessary tools"라는 체크박스가 보일 수 있습니다. Gemini CLI를 사용하는 목적만으로는 이 옵션을 체크할 필요가 없습니다. 이는 더 복잡한 개발 환경을 위한 것이므로, 체크하지 않고 'Next'를 눌러 진행합니다.  
  4. 설치 완료: 마지막 화면에서 'Finish' 버튼을 누르면 모든 설치 과정이 끝납니다.

중요 팁: 만약 Windows 사용자 이름이 한글로 되어 있다면, 일부 개발 도구에서 예측하지 못한 오류가 발생할 수 있습니다. 대부분의 경우 문제가 없지만, 나중에 설명할 수 없는 오류가 계속된다면 영문으로 된 새 사용자 계정을 만들어보는 것도 하나의 해결 방법이 될 수 있습니다.  

 

1.3 확인 작업: 모든 준비가 끝났나요?

Node.js가 올바르게 설치되었는지 확인하는 것은 매우 중요합니다. 이 간단한 확인 작업을 통해 다음 단계로 넘어가기 전에 문제를 미리 발견할 수 있습니다.

  1. Windows '명령 프롬프트(Command Prompt)' 또는 'PowerShell'을 실행합니다. (시작 메뉴에서 'cmd' 또는 'powershell'을 검색하여 실행할 수 있습니다.)
  2. 열린 검은색 터미널 창에 다음 명령어를 한 줄씩 입력하고 각 줄마다 Enter 키를 누릅니다.이 명령어는 설치된 Node.js의 버전을 확인합니다. v20.14.0과 같이 버전 번호가 나타나면 성공입니다.   
    node -v

     

  3. 다음으로, 아래 명령어를 입력하고 Enter 키를 누릅니다.이 명령어는 함께 설치된 npm의 버전을 확인합니다. 마찬가지로 버전 번호가 보이면 모든 준비가 완벽하게 끝난 것입니다.   
    npm -v

     

4. 만약 이 명령어들을 입력했을 때 '명령을 찾을 수 없습니다' 또는 'is not recognized'와 같은 오류 메시지가 나타난다면, '환경 변수(PATH)' 설정에 문제가 있는 것입니다. 이 경우, 이 가이드의 마지막에 있는 6부: 일반적인 Windows 문제 해결하기를 참고하여 문제를 해결할 수 있습니다.  

 

2부: Gemini에 생명 불어넣기 - 설치와 첫 만남

이제 모든 사전 준비가 끝났으니, 오늘의 주인공인 Gemini CLI를 우리 컴퓨터에 설치할 차례입니다. 이 과정은 놀라울 정도로 간단합니다.

2.1 본 게임: Gemini CLI 설치하기

앞서 Node.js와 함께 설치된 패키지 관리자 npm 덕분에, 우리는 단 한 줄의 명령어로 Gemini CLI를 설치할 수 있습니다.

  1. 새로운 명령 프롬프트 또는 PowerShell 창을 엽니다.
  2. 다음 명령어를 그대로 복사하여 붙여넣고 Enter 키를 누릅니다.이 명령어는 Gemini CLI를 인터넷에서 다운로드하여 컴퓨터의 모든 위치에서 사용할 수 있도록 '전역(global)'으로 설치합니다. 명령어의   -g 부분이 바로 이 '전역 설치'를 의미합니다. 설치가 진행되는 동안 몇 줄의 텍스트가 올라가며, 잠시 후 완료됩니다. 
    npm install -g @google/gemini-cli

2.2 첫 실행과 인증

이제 Gemini CLI가 여러분의 컴퓨터에 설치되었습니다. AI 비서와의 첫 만남을 가져봅시다.

  1. 설치가 완료된 터미널 창에 다음 명령어를 입력하고 Enter 키를 누릅니다. 
    gemini

     

  2. Gemini CLI가 처음으로 실행되면 몇 가지 초기 설정을 진행합니다.  
    • 테마 선택: 먼저, 터미널의 색상 테마를 선택하라는 메시지가 나타납니다. 방향키로 마음에 드는 테마를 고르고 Enter를 누릅니다.  
    • 인증: 다음으로, Gemini 서비스를 사용하기 위해 인증 절차를 거칩니다. 터미널에 나타나는 안내에 따라 진행하면, 자동으로 웹 브라우저 창이 열리며 익숙한 Google 로그인 화면이 나타납니다. 여러분의 개인 Google 계정으로 로그인하면 됩니다.  
  이 간단한 로그인 과정만으로도 여러분은 매우 관대한 Gemini의 무료 사용량을 얻게 됩니다. 여기에는 최신 모델인 Gemini 2.5 Pro 사용, 한 번에 책 수백 권 분량의 정보를 처리할 수 있는 100만 토큰 컨텍스트 창, 분당 60회 및 하루 1,000회의 요청이라는 업계 최고 수준의 혜택이 포함됩니다. 신용카드 정보도 필요 없습니다.  
이러한 접근성은 Gemini CLI의 가장 큰 장점 중 하나입니다. 많은 개발자 도구들이 복잡한 API 키 발급이나 유료 결제를 요구하는 것과 달리, Gemini CLI는 간단한 설치와 친숙한 Google 로그인만으로 강력한 AI의 세계를 열어줍니다.

2.3 첫 번째 대화

모든 설치와 인증이 성공적으로 끝났는지 확인하기 위해, Gemini와 간단한 첫 대화를 나눠보겠습니다. Gemini CLI가 실행된 터미널 창은 이제 프롬프트가 > 모양으로 바뀌어 여러분의 입력을 기다리고 있을 것입니다. 다음과 같이 질문을 입력해보세요.

> 안녕하세요! 제미나이 CLI가 무엇인지 간단히 설명해주세요.

 

잠시 후, Gemini가 유창한 한국어로 자신을 소개하는 답변을 생성한다면 모든 과정이 성공적으로 완료된 것입니다. 이제 여러분은 터미널에서 AI와 직접 대화할 수 있게 되었습니다.

3부: 진정한 힘의 개방 - MCP로 로컬 파일 접근하기

지금까지의 과정만으로도 Gemini CLI는 훌륭한 대화형 AI 도구입니다. 하지만 Gemini CLI의 진정한 잠재력은 'Model Context Protocol(MCP)'이라는 기술을 통해 발휘됩니다. MCP는 Gemini가 여러분의 컴퓨터와 상호작용하고, 외부 도구를 사용하며, 그 능력을 무한히 확장할 수 있게 해주는 핵심 열쇠입니다.

3.1 핵심 개념: 모델 컨텍스트 프로토콜(MCP)이란?

MCP는 Gemini의 능력을 확장하는 표준화된 방법입니다. 이 개념을 쉽게 이해하기 위해 강력한 비유를 들어보겠습니다.  

"MCP는 AI를 위한 USB 포트와 같습니다. AI 자체만으로도 똑똑하지만, MCP라는 포트가 있으면 여기에 다양한 장치를 연결할 수 있습니다. 예를 들어, 외장 하드 드라이브(여러분의 로컬 파일 시스템), 웹캠(이미지 생성 도구), 또는 랜선(웹 검색 도구)을 꽂아 AI의 능력을 확장하는 것입니다."  

 

 이 구조에서 Gemini CLI는 다양한 장치를 연결할 수 있는 '호스트(host)' 또는 '클라이언트(client)' 역할을 합니다. 그리고 우리가 지금부터 설치할 것은 '파일 시스템(filesystem)'이라는 기능을 제공하는 '서버(server)'입니다. 이 서버를 연결하면, Gemini는 여러분의 컴퓨터에 있는 파일과 폴더를 읽고, 쓰고, 관리할 수 있게 됩니다.  

3.2 첫 MCP 서버 설정하기: 파일 시스템 서버
 

 모든 MCP 서버 설정은 단 하나의 설정 파일(settings.json)에서 이루어집니다. 이 파일을 올바르게 찾고 수정하는 것이 가장 중요한 단계입니다.

  1. 설정 파일 위치 찾기: Windows 사용자를 위한 가장 쉬운 방법은 다음과 같습니다.
    • '파일 탐색기'를 엽니다.
    • 주소창에 %USERPROFILE%을 입력하고 Enter 키를 누릅니다. 이렇게 하면 여러분의 사용자 홈 폴더(예: C:\Users\YourName)로 바로 이동합니다.
    • 이 폴더에서 .gemini라는 이름의 폴더를 찾습니다. 만약 이 폴더가 보이지 않는다면, '보기' 탭에서 '숨긴 항목'을 체크해야 보일 수 있습니다. 폴더가 없다면, 마우스 오른쪽 버튼을 클릭하여 '새로 만들기' -> '폴더'를 선택하고 .gemini라는 이름으로 폴더를 만듭니다.
    • .gemini 폴더 안으로 들어갑니다.
  2. 설정 파일 생성 및 수정:
    • .gemini 폴더 안에서 settings.json 파일을 찾아 마우스 오른쪽 버튼을 클릭하여 메모장으로 열기를 선택합니다.
    • 파일의 밑에 "mcpServers": 부터 붙여넣어 아래의 구조로 만듭니다.
  3. JSON 코드 붙여넣기: 열린 settings.json 파일에 아래의 코드 형태로 복사하여 붙여넣습니다. 
    {
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "@google/gemini-cli",
        "fs",
        "--dir",
        "C:\\Users\\사용자"
      ]
    }
  }
}

     

  4. 경로 수정하기: 위 코드에서 가장 중요한 부분은 args 배열 안의 경로입니다.
    • 사용자 부분을 여러분의 실제 Windows 사용자 이름으로 바꾸세요.
    • "C:\\Users\\사용자\\Desktop"은 바탕화면 폴더에 대한 접근을 허용합니다.
    • "C:\\Users\\사용자"는 내 문서 안의 자식폴더까지 접근을 허용합니다. 여러분이 작업할 다른 폴더 경로를 이와 같은 형식으로 추가할 수 있습니다.
    • 매우 중요한 Windows 규칙: 파일 탐색기에서 보이는 경로(예: C:\Users)와 달리, JSON 파일 안에서는 반드시 백슬래시를 두 번(\\) 사용해야 합니다. 이것은 초보자들이 가장 흔하게 겪는 실수이므로 꼭 기억해주세요.  
    •   "theme": "Default",  "selectedAuthType": "oauth-personal", 부분은 최초 Gemini 실행시 설정으로 삭제하면 안됩니다.

보안을 위한 최고의 습관: 여기서 "최소 권한의 원칙(Principle of Least Privilege)"을 기억하는 것이 좋습니다. Gemini가 여러분의 컴퓨터 전체( C:\\)에 접근하도록 허용하는 대신, 작업에 꼭 필요한 특정 폴더(예: 바탕화면, 프로젝트 폴더)만 추가하는 것이 안전합니다. 이렇게 하면 AI가 실수로 중요한 시스템 파일을 변경하는 것을 방지할 수 있습니다.

3.3 테스트 시간: 자연어로 파일 관리하기

설정이 완료되었으면, settings.json 파일을 저장하고 모든 명령 프롬프트 창을 닫았다가 새로 열어 Gemini CLI를 다시 시작하세요. 이제 Gemini는 여러분의 파일 시스템과 대화할 준비가 되었습니다. 아래 표는 여러분이 바로 사용해볼 수 있는 유용한 명령어 예시입니다.

 

표 1: 로컬 파일 시스템 마스터하기

기능 (Function) 제공 도구 (Tool Name) 자연어 프롬프트 예시 (Example Prompt)
폴더 내용 보기 list_directory 내 바탕화면에 있는 파일 목록을 보여줘
파일 읽기 read_file 바탕화면에 있는 'test.txt' 파일의 내용을 읽어줘
파일 생성 및 작성 write_file 바탕화면에 'hello.txt'라는 파일을 만들고 "Hello, World!"라고 적어줘
폴더 생성 create_directory 내 문서 폴더 안에 'New-Project'라는 이름의 새 폴더를 만들어줘
파일 이동 move_file 바탕화면에 있는 'report.docx' 파일을 내 문서 폴더로 옮겨줘
파일 삭제 delete_file 바탕화면에 있는 'old_screenshot.png' 파일을 삭제해줘
Sheets로 내보내기

이 표는 여러분이 방금 완료한 설정 작업에 대한 보상입니다. 이제 여러분은 복잡한 명령어를 외울 필요 없이, 사람에게 말하듯 자연스러운 언어로 컴퓨터의 파일을 정리하고 관리할 수 있게 되었습니다. 이는 Gemini CLI와 MCP가 제공하는 생산성 향상의 시작일 뿐입니다.

4부: 툴킷 확장하기 - MCP의 세계로

이제 여러분은 Gemini CLI에 기능을 추가하는 핵심 원리, 즉 settings.json 파일을 수정하는 방법을 배웠습니다. 이 원리를 이해했다면, 이제 파일 시스템을 넘어 더 넓은 MCP의 세계를 탐험할 준비가 된 것입니다. MCP는 개방형 표준이기 때문에, 전 세계 개발자들이 만든 수많은 도구 생태계가 이미 존재합니다.

4.1 새로운 MCP 서버를 발견하는 방법

새로운 'USB 장치'를 어디서 찾을 수 있을까요? MCP 서버를 발견하는 주요 장소는 다음과 같습니다.

  • MCP 마켓플레이스: mcpmarket.com과 같은 웹사이트는 MCP 서버들을 위한 거대한 온라인 상점과 같습니다. 이곳에서 개발자 도구, API 연동, 데이터 과학 등 다양한 카테고리별로 정리된 서버들을 둘러보고, 인기 순위나 최신 순위로 정렬하여 탐색할 수 있습니다.  
  • 커뮤니티 큐레이션 목록: GitHub에는 "Awesome MCP Servers"와 같은 이름으로 사용자들이 직접 유용한 오픈소스 MCP 서버들을 모아놓은 목록들이 있습니다 (예: wong2/awesome-mcp-servers, punkpeye/awesome-mcp-servers). 새로운 아이디어를 얻거나 특정 문제를 해결할 도구를 찾기에 아주 좋은 장소입니다.  

4.2 사례 연구: GitHub MCP 서버 설치하기

다음 실습으로 GitHub 서버를 설치해보겠습니다. 이 서버를 선택한 이유는 단순히 또 다른 기능을 추가하는 것을 넘어, 현대적인 개발 도구 연동의 핵심 개념인 'API 토큰을 이용한 인증'을 배울 수 있기 때문입니다.  

 

4.2.1 1단계: GitHub 개인용 액세스 토큰(PAT) 발급받기

GitHub 서버는 여러분을 대신하여 저장소(repository)를 읽거나 이슈를 생성하는 등의 작업을 수행해야 하므로, 여러분의 허가를 증명하는 '비밀 열쇠'가 필요합니다. 이것이 바로 개인용 액세스 토큰(Personal Access Token, PAT)입니다.

  1. GitHub 웹사이트에 로그인합니다.
  2. 오른쪽 상단의 프로필 아이콘을 클릭하고 'Settings'로 이동합니다.
  3. 왼쪽 메뉴 하단의 'Developer settings'를 클릭합니다.
  4. 'Personal access tokens' -> 'Tokens (classic)'을 선택하고 'Generate new token' 버튼을 클릭합니다.
  5. 토큰의 용도를 적는 'Note' 란에 'Gemini CLI'와 같이 알아보기 쉽게 적어줍니다.
  6. 'Expiration'에서 토큰의 유효 기간을 설정합니다.
  7. 'Select scopes'에서 이 토큰에게 부여할 권한을 선택합니다. 시작 단계에서는 repo (private 저장소 포함 모든 저장소 접근), read:org (소속된 조직 정보 읽기) 정도를 체크하면 대부분의 기능을 사용할 수 있습니다.
  8. 페이지 하단의 'Generate token' 버튼을 클릭합니다.

경고: 생성된 토큰은 이 화면을 벗어나면 다시는 볼 수 없습니다. 반드시 안전한 곳(예: 비밀번호 관리자)에 즉시 복사해두세요.

4.2.2 2단계: Windows 환경 변수로 토큰 안전하게 보관하기

발급받은 토큰은 매우 민감한 정보입니다. 이 비밀 열쇠를 settings.json 파일에 직접 붙여넣는 것은 매우 위험한 행동입니다. 실수로 이 파일을 다른 사람에게 공유라도 하면, 여러분의 GitHub 계정 전체가 위험에 빠질 수 있습니다.

대신, 우리는 '환경 변수(Environment Variable)'라는 안전한 보관함을 사용할 것입니다. 환경 변수는 코드나 설정 파일과 비밀 정보를 분리하여 안전하게 관리하는 표준적인 방법입니다. Windows에서 환경 변수를 설정하는 방법은 두 가지가 있습니다.

 

표 2: Windows에서 환경 변수 설정하기

방법 (Method) 장점 (Pros) 단점 (Cons) 단계 요약 (Summary of Steps)
GUI (그래픽 인터페이스) 초보자에게 직관적이고 쉬움. 클릭이 많고, 자동화가 어려움. 1. 시작 메뉴에서 '시스템 환경 변수 편집'을 검색하여 실행합니다. 2. '환경 변수' 버튼을 클릭합니다. 3. '사용자 변수' 섹션에서 '새로 만들기'를 클릭합니다. 4. 변수 이름에 GITHUB_PERSONAL_ACCESS_TOKEN을, 변수 값에 방금 복사한 토큰을 붙여넣습니다. 5. 모든 창을 '확인' 버튼을 눌러 닫습니다.
Command Line (명령줄) 빠르고, 스크립트로 자동화 가능. 명령어를 기억해야 함. 1. 명령 프롬프트(cmd)를 실행합니다. 2. setx GITHUB_PERSONAL_ACCESS_TOKEN "여기에_토큰을_붙여넣으세요" 명령어를 실행합니다. 3.  
 

 중요: setx로 설정한 변수는 현재 창이 아닌, 새로 여는 명령 프롬프트 창부터 적용됩니다.

이 표는 여러분의 편의에 따라 선택할 수 있는 두 가지 길을 제시합니다. GUI 방식은 시각적이라 안심이 되고, setx 명령어는 개발자처럼 더 빠르고 효율적인 방법을 알려줍니다. 어떤 방법을 선택하든, 여러분은 개발의 기본 소양 중 하나인 '비밀 정보의 안전한 관리'를 배우게 되는 것입니다.

4.2.3 3단계: settings.json 업데이트하기

이제 안전한 보관함에 비밀 열쇠를 넣었으니, settings.json 파일에게 그 보관함의 위치를 알려줄 차례입니다.

  1. 앞서 만들었던 %USERPROFILE%\.gemini\settings.json 파일을 다시 엽니다.
  2. 기존 mcpServers 객체 안에 github 서버 설정을 추가합니다. 파일의 최종 모습은 다음과 같아야 합니다.여기서 ${GITHUB_PERSONAL_ACCESS_TOKEN} 구문이 핵심입니다. 이는 Gemini CLI에게 "이 값을 직접 찾지 말고, GITHUB_PERSONAL_ACCESS_TOKEN이라는 이름의 환경 변수를 찾아서 그 값을 사용해라"라고 알려주는 특별한 문법입니다. 이렇게 함으로써 우리는 민감한 정보를 설정 파일로부터 완벽하게 분리했습니다. 
     
    {
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args":
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

4.2.4 4단계: 테스트하기

settings.json 파일을 저장하고, 환경 변수 설정을 완료한 후에는 반드시 모든 터미널 창을 닫았다가 새로 열어야 합니다. 그래야 새로 설정된 환경 변수를 Gemini CLI가 인식할 수 있습니다.

새 터미널에서 gemini를 실행하고 다음과 같이 질문해보세요.

> 내 GitHub 계정에 있는 public 저장소 목록을 보여줘.

Gemini가 여러분의 GitHub 계정에 접속하여 저장소 목록을 성공적으로 가져온다면, 여러분은 이제 로컬 파일을 넘어 인터넷상의 서비스와 연동하는 더 높은 수준의 AI 활용법을 마스터한 것입니다.

5부: 스타터 팩 - 추천 MCP와 마지막 팁

이제 여러분은 Gemini CLI를 확장하는 방법을 완전히 이해했습니다. 하지만 수많은 MCP 서버 중에서 어떤 것을 먼저 써봐야 할지 막막할 수 있습니다. 여러분의 여정을 돕기 위해 몇 가지 유용한 MCP 서버를 추천하고, Gemini CLI를 더 잘 활용하기 위한 몇 가지 팁을 알려드립니다.

5.1 초보자를 위한 추천 MCP 서버 목록

아래 표는 여러분이 바로 시작해볼 수 있는 유용하고 흥미로운 MCP 서버들을 정리한 것입니다.

 

표 3: 초보자를 위한 추천 MCP 서버

MCP 서버 (MCP Server) 핵심 기능 (Core Function) 설치가 필요한가요? (Installation Needed?) settings.json 예시 (mcpServers 항목)
Filesystem (@modelcontextprotocol/server-filesystem) 로컬 파일/폴더 읽기, 쓰기, 관리 아니요, npx가 자동으로 처리합니다. { "filesystem": { "command": "npx", "args": } }
GitHub (@modelcontextprotocol/server-github) GitHub 저장소, 이슈, PR과 상호작용 아니요, npx가 자동으로 처리합니다. (PAT 필요) { "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"} } }
Sequential Thinking (@modelcontextprotocol/server-sequential-thinking) 복잡한 문제를 단계별 생각의 사슬로 분해하여 해결  
 

 아니요, npx가 자동으로 처리합니다. { "sequential-thinking": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"] } }

 

 이 표는 여러분이 배운 내용을 복습하고, 'Sequential Thinking'과 같이 AI의 사고 과정을 엿볼 수 있는 새로운 도구를 소개하여 탐험을 장려합니다. settings.json에 해당 코드를 추가하기만 하면 바로 새로운 능력을 시험해볼 수 있습니다.

5.2 알아두면 유용한 명령어들

Gemini CLI 자체를 관리하고 상태를 확인하는 데 유용한 몇 가지 내장 명령어가 있습니다. 이 명령어들은 슬래시(/)로 시작합니다.  

 
  • /tools: 현재 로드된 모든 MCP 서버가 제공하는 도구들의 전체 목록을 보여줍니다. 어떤 명령을 내릴 수 있는지 궁금할 때 유용합니다.
  • /mcp: 연결된 MCP 서버들의 목록과 연결 상태를 확인합니다. 서버가 제대로 작동하지 않을 때 원인을 파악하는 데 도움이 됩니다.
  • /memory: GEMINI.md라는 파일을 통해 Gemini에게 특별한 지침(예: "너는 파이썬 전문가야", "코드는 항상 이 스타일 가이드에 맞춰 작성해줘")을 줄 수 있는데, 이 명령어는 현재 적용된 지침을 보여주거나 새로고침합니다.
  • /help: 사용 가능한 모든 슬래시 명령어 목록을 보여줍니다.

5.3 고급 사용자를 위한 API 키 안내

지금까지 우리는 Google 계정 로그인만으로 제공되는 관대한 무료 사용량으로 모든 것을 해결했습니다. 하지만 만약 여러분이 전문가가 되어 하루에 수천 번 이상 Gemini를 사용하거나, 기업 환경에서 보안이 강화된 방식으로 사용하고 싶다면 'API 키'를 사용하는 고급 경로도 있습니다.

Google AI Studio에서 GEMINI_API_KEY를 발급받아 앞서 배운 환경 변수 설정 방법으로 등록하면, 사용량 기반 과금제로 전환하여 훨씬 더 높은 한도로 Gemini를 사용할 수 있습니다. 지금 당장 필요한 것은 아니지만, 여러분의 성장을 위한 다음 단계로 이런 길이 있다는 것을 알아두는 것만으로도 충분합니다.  

6부: 일반적인 Windows 문제 해결하기
 

모든 것이 순조롭게 진행되면 좋겠지만, 때로는 예상치 못한 문제에 부딪힐 수 있습니다. 특히 Windows 환경에서는 몇 가지 흔한 문제들이 있습니다. 이 섹션은 여러분이 마주할 수 있는 문제들을 미리 예측하고 해결책을 제시하는, 전문가 가이드의 핵심적인 부분입니다.

6.1 문제: MCP 서버가 연결되지 않아요 (npx 문제)

증상: settings.json에 파일 시스템이나 GitHub 서버를 올바르게 추가했지만, gemini를 실행했을 때 해당 도구들이 활성화되지 않고 연결에 실패하는 경우가 있습니다.

원인: 일부 Windows 시스템, 특히 NVM(Node Version Manager)과 같은 도구로 Node.js를 관리하는 경우, Gemini CLI 내부에서 npx 명령어를 실행하는 데 문제가 발생할 수 있습니다.  

 

해결책: 이 문제는 npx에 의존하는 대신, 필요한 서버를 컴퓨터에 직접 '전역 설치'하고 그 파일의 절대 경로를 settings.json에 명시해주는 방식으로 해결할 수 있습니다.

  1. 서버 전역 설치: 명령 프롬프트에 다음 명령어를 실행하여 파일 시스템 서버를 직접 설치합니다. 
    npm install -g @modelcontextprotocol/server-filesystem

     

  2. Node.js 실행 파일 경로 찾기: 명령 프롬프트에 where node를 입력하여 node.exe 파일의 전체 경로를 확인하고 복사합니다. (예: D:\Program\nvm\node.exe)
  3. 전역 npm 모듈 폴더 경로 찾기: 명령 프롬프트에 npm root -g를 입력하여 전역으로 설치된 패키지들이 위치한 폴더 경로를 확인하고 복사합니다. (예: D:\Program\nvm\node_modules)
  4. settings.json 수정: 이제 settings.json을 열어 filesystem 서버 설정을 다음과 같이 절대 경로를 사용하도록 수정합니다. 경로는 여러분의 컴퓨터에서 확인된 실제 경로로 바꿔야 하며, 백슬래시는 반드시 두 번(\\) 사용해야 합니다.이 방법은 npx의 모호한 동작을 우회하고, Gemini CLI에게 정확히 어떤 프로그램을 실행해야 할지 명확하게 알려주므로 매우 효과적인 해결책입니다.   
    {
  "mcpServers": {
    "filesystem": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args":
    }
    //... 다른 서버 설정...
  }
}

6.2 문제: 'gemini' 명령어를 찾을 수 없어요

증상: npm install -g @google/gemini-cli 설치는 성공한 것처럼 보였지만, 터미널에 gemini를 입력하면 '명령을 찾을 수 없습니다' 또는 'is not recognized' 오류가 발생합니다.

원인: Node.js 설치 과정에서 시스템의 PATH 환경 변수에 Node.js 경로가 제대로 추가되지 않았기 때문입니다.  

 

PATH는 Windows가 명령어의 실행 파일을 어디서 찾아야 할지 알려주는 주소 목록과 같습니다.

해결책: PATH 변수에 Node.js 경로를 수동으로 추가해야 합니다.

  1. '시스템 환경 변수 편집'을 검색하여 실행합니다.
  2. '환경 변수' 버튼을 클릭합니다.
  3. '시스템 변수' 목록에서 Path를 찾아 선택하고 '편집'을 클릭합니다.
  4. '새로 만들기'를 클릭하고 C:\Program Files\nodejs\를 입력합니다.
  5. 모든 창을 '확인'을 눌러 닫고, 컴퓨터를 재부팅하거나 모든 터미널 창을 닫고 새로 열면 문제가 해결됩니다.

드물지만 PowerShell의 스크립트 실행 정책 때문에 문제가 발생할 수도 있습니다. 위 방법으로 해결되지 않을 경우 다음을 시도해 보세요.

  1. PowerShell을 관리자 권한으로 실행합니다.
  2. Get-ExecutionPolicy 명령어로 현재 정책을 확인합니다. 만약 Restricted로 되어 있다면 정책을 변경해야 합니다.
  3. Set-ExecutionPolicy RemoteSigned 명령어를 입력하고 Y를 눌러 정책을 변경합니다.

6.3 문제: settings.json 파일이 잘못되었어요

증상: settings.json을 수정한 후 gemini를 실행하면 오류가 발생하거나 MCP 서버가 로드되지 않습니다.

원인: JSON 파일은 문법이 매우 엄격합니다. 쉼표(,) 하나, 중괄호({}) 하나만 잘못되어도 전체 파일이 깨질 수 있습니다.

해결책: 파일을 다시 열어 다음 사항들을 확인하세요.

  • 각 서버 설정 객체 사이에 쉼표(,)가 있는지 확인하세요. (예: "filesystem": {... }, "github": {... })
  • 목록의 마지막 항목 뒤에는 쉼표가 없어야 합니다.
  • 모든 여는 중괄호({)는 닫는 중괄호(})와 짝이 맞는지 확인하세요.
  • Windows 경로에 백슬래시가 두 번(\\) 사용되었는지 다시 한번 확인하세요.

7부: 결론 - AI 기반 개발자로서의 여정을 시작하며

이 가이드를 끝까지 따라오신 것을 축하합니다. 여러분은 이제 단순한 사용자에서 한 걸음 나아가, 자신의 필요에 맞게 AI 도구를 설정하고 확장할 수 있는 능력을 갖추게 되었습니다.

여러분은 이 과정을 통해 다음과 같은 중요한 성과를 이루었습니다.

  • Windows PC에 Node.js 개발 환경을 성공적으로 구축했습니다.
  • 강력한 AI 에이전트인 Gemini CLI를 설치하고 인증했습니다.
  • MCP라는 핵심 개념을 이해하고, 파일 시스템 서버를 연결하여 Gemini가 여러분의 로컬 컴퓨터와 직접 상호작용하도록 만들었습니다.
  • GitHub 서버를 설치하며 API 토큰을 발급받고 환경 변수를 통해 안전하게 관리하는, 현대적인 개발의 필수 기술을 습득했습니다.

가장 중요한 것은, 여러분이 이제 settings.json이라는 '마법의 책'을 통해 Gemini CLI의 능력을 무한히 확장할 수 있는 방법을 배웠다는 사실입니다. 오늘 배운 파일 시스템과 GitHub 연동은 시작에 불과합니다. MCP 생태계에는 웹 검색, 데이터베이스 연결, 이미지 생성 등 여러분의 상상력을 자극할 수많은 도구들이 기다리고 있습니다.

두려워하지 말고 실험하세요. mcpmarket.com을 둘러보고, 흥미로운 서버를 settings.json에 추가해보세요. 때로는 실패하고 오류를 마주하겠지만, 이 가이드의 문제 해결 섹션에서 배운 것처럼, 그 과정 자체가 여러분을 더 유능한 기술자로 성장시킬 것입니다.

여러분의 터미널은 이제 더 이상 단순한 검은 창이 아닙니다. 그것은 여러분의 아이디어를 현실로 만들어 줄 강력하고 지능적인 파트너, Gemini와 함께하는 작업 공간입니다.

더 깊이 있는 학습을 원하신다면, 아래의 공식 자료들을 참고하세요.

이제 여러분의 AI 기반 개발 여정이 시작되었습니다. 행운을 빕니다!

'IT 관련 > AI' 카테고리의 다른 글

입출력단위 '토큰(Token)'에 대하여  (0) 2025.09.03
2025 생성형 AI 도구 분석  (4) 2025.06.08
2025년 5월 최신 AI 트렌드: 초거대 AI부터 초개인화 비서까지!  (1) 2025.05.21
Manus가 작성해준 일본 여행 스케줄  (1) 2025.03.25
Manus 활용한 정보 수집 사례  (0) 2025.03.25

'IT 관련/AI'의 다른글

  • 현재글Windows PC에서 Gemini CLI와 MCP 서버 설치

관련글

티스토리툴바