Google Drive MCP Server

구글 드라이브 서버

이 MCP 서버는 Google Drive와 통합되어 파일을 나열하고, 읽고, 검색할 수 있습니다.

구성 요소

도구

• 찾다
  • Google 드라이브에서 파일 검색
  • 입력: query (문자열): 검색 쿼리
  • 일치하는 파일의 파일 이름과 MIME 유형을 반환합니다.

자원

이 서버는 Google Drive 파일에 대한 액세스를 제공합니다.

• 파일 ( gdrive:///<file_id> )
  • 모든 파일 유형을 지원합니다
  • Google Workspace 파일은 자동으로 내보내집니다.
    • 문서 → 마크다운
    • 시트 → CSV
    • 프레젠테이션 → 일반 텍스트
    • 도면 → PNG
  • 다른 파일은 원래 형식으로 제공됩니다.

시작하기

1. 새로운 Google Cloud 프로젝트를 만듭니다.
2. Google 드라이브 API 활성화
3. OAuth 동의 화면을 구성합니다 (테스트에는 "내부"가 적합합니다)
4. OAuth 범위 추가 https://www.googleapis.com/auth/drive.readonly
5. "데스크톱 앱" 애플리케이션 유형에 대한 OAuth 클라이언트 ID를 만듭니다.
6. 클라이언트의 OAuth 키 JSON 파일을 다운로드하세요.
7. 키 파일의 이름을 gcp-oauth.keys.json 으로 바꾸고 이 리포의 루트(예: servers/gcp-oauth.keys.json )에 넣습니다.

npm run build 또는 npm run watch 사용하여 서버를 빌드하세요.

입증

자격 증명을 인증하고 저장하려면:

1. auth 인수로 서버를 실행합니다: node ./dist auth
2. 이렇게 하면 시스템 브라우저에서 인증 흐름이 열립니다.
3. 인증 과정을 완료하세요
4. 자격 증명은 이 저장소의 루트(예: servers/.gdrive-server-credentials.json )에 저장됩니다.

데스크톱 앱 사용

이 서버를 데스크톱 앱과 통합하려면 앱의 서버 구성에 다음을 추가하세요.

도커

입증:

Google Cloud에서 OAuth 애플리케이션 설정을 완료했다고 가정하면 이제 다음 명령을 사용하여 서버를 인증할 수 있습니다. 여기서 /path/to/gcp-oauth.keys.json OAuth 키 파일 경로로 바꿉니다.

지엑스피1

이 명령은 브라우저에서 열 URL을 출력합니다. 브라우저에서 이 URL을 열고 인증 절차를 완료하세요. 자격 증명은 mcp-gdrive 볼륨에 저장됩니다.

인증이 완료되면 앱의 서버 구성에서 해당 서버를 사용할 수 있습니다.

엔피엑스

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.