Google 드라이브 MCP 서버

Google Drive와 원활하게 통합되는 강력한 MCP(Model Context Protocol) 서버로, AI 모델이 Google Drive에서 파일을 검색, 나열, 읽을 수 있습니다.

🚀 특징

도구

1. gdrive_search

강력한 전체 텍스트 검색 기능으로 Google 드라이브에서 파일을 검색하세요.

• 입력 :지엑스피1
• 출력 : 다음이 포함된 파일 목록:
  • 파일 이름
  • MIME 유형
  • 파일 ID
  • 마지막 수정 시간
  • 파일 크기

2. gdrive_read_file

Google Drive 파일 ID를 사용하여 파일 내용을 직접 읽습니다.

• 입력 :
  { "file_id": "string (Google Drive file ID)" }
• 출력 : 적절한 형식 변환을 포함한 파일 내용

자동 파일 형식 처리

서버는 다양한 Google Workspace 파일 유형을 지능적으로 처리합니다.

• 📝 Google Docs → 마크다운
• 📊 Google 시트 → CSV
• 📊 Google 프레젠테이션 → 일반 텍스트
• 🎨 구글 드로잉 → PNG
• 📄 텍스트/JSON 파일 → UTF-8 텍스트
• 📦 기타 파일 → Base64 인코딩

🛠️ 시작하기

필수 조건

• Node.js(v16 이상)
• npm 또는 yarn
• Google Cloud 프로젝트
• Google Workspace 또는 개인 Google 계정

자세한 Google Cloud 설정

1. Google Cloud 프로젝트 만들기
   • Google Cloud Console을 방문하세요
   • "새 프로젝트"를 클릭하세요
   • 프로젝트 이름을 입력하세요(예: "MCP GDrive Server")
   • "만들기"를 클릭하세요
   • 프로젝트가 생성될 때까지 기다렸다가 선택하세요
2. Google 드라이브 API 활성화
   • API 라이브러리 로 이동
   • "Google 드라이브 API"를 검색하세요
   • "Google Drive API"를 클릭하세요
   • "활성화"를 클릭하세요
   • API가 활성화될 때까지 기다리세요
3. OAuth 동의 화면 구성
   • OAuth 동의 화면 으로 이동합니다.
   • 사용자 유형 선택:
     • Google Workspace를 사용하는 경우 "내부"
     • 개인 Google 계정의 경우 "외부"
   • "만들기"를 클릭하세요
   • 필수 입력란을 입력하세요:
     • 앱 이름: "MCP GDrive Server"
     • 사용자 지원 이메일: 귀하의 이메일
     • 개발자 연락처 이메일: 귀하의 이메일
   • "저장하고 계속"을 클릭하세요
   • "범위" 페이지에서:
     • "범위 추가 또는 제거"를 클릭하세요.
     • https://www.googleapis.com/auth/drive.readonly 를 추가하세요
     • "업데이트"를 클릭하세요
   • "저장하고 계속"을 클릭하세요
   • 요약을 검토하고 "대시보드로 돌아가기"를 클릭하세요.
4. OAuth 클라이언트 ID 생성
   • 자격 증명 으로 이동
   • 상단의 "자격 증명 만들기"를 클릭하세요.
   • "OAuth 클라이언트 ID"를 선택하세요
   • 애플리케이션 유형을 선택하세요: "데스크톱 앱"
   • 이름: "MCP GDrive Server 데스크톱 클라이언트"
   • "만들기"를 클릭하세요
   • 팝업에서:
     • "JSON 다운로드"를 클릭하세요
     • 파일을 저장하세요
     • "확인"을 클릭하세요
5. 프로젝트에 자격 증명 설정
   # Create credentials directory mkdir credentials # Move and rename the downloaded JSON file mv path/to/downloaded/client_secret_*.json credentials/gcp-oauth.keys.json

설치

입증

1. 자격 증명 디렉토리를 만들고 OAuth 키를 배치하세요.
   mkdir credentials # Move your downloaded OAuth JSON file to the credentials directory as gcp-oauth.keys.json
2. 인증 명령을 실행합니다.
   node dist/index.js auth
3. 브라우저에서 OAuth 흐름을 완료하세요
4. 자격 증명은 credentials/.gdrive-server-credentials.json 에 저장됩니다.

🔧 사용법

명령줄 도구로

데스크톱 앱과의 통합

앱의 서버 설정에 다음 구성을 추가하세요.

path/to/gdrive-mcp-server 설치 디렉토리의 실제 경로로 바꾸세요.

사용 예

1. 파일 검색 :
   // Search for documents containing "quarterly report" const result = await gdrive_search({ query: "quarterly report" });
2. 파일 내용 읽기 :
   // Read a specific file using its ID const contents = await gdrive_read_file({ file_id: "your-file-id" });

🔒 보안

• 모든 민감한 자격 증명은 credentials 디렉토리에 저장됩니다.
• OAuth 자격 증명 및 토큰은 버전 제어에서 제외됩니다.
• Google 드라이브에 대한 읽기 전용 액세스
• 보안 OAuth 2.0 인증 흐름

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

📝 라이센스

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

🔍 문제 해결

문제가 발생하는 경우:

1. Google Cloud Project 설정을 확인하세요
2. 모든 필수 OAuth 범위가 활성화되어 있는지 확인하세요.
3. 자격 증명이 credentials 디렉토리에 제대로 배치되었는지 확인하세요.
4. Google Drive에서 파일 권한 및 액세스 권한 확인

📚 추가 자료

• Google 드라이브 API 문서
• 데스크톱 앱용 OAuth 2.0
• 모델 컨텍스트 프로토콜 문서