Google Drive MCP Server

구글 드라이브 서버

이 MCP 서버는 Google Drive와 통합되어 파일을 나열하고, 읽고, 검색할 수 있을 뿐만 아니라 Google Sheets를 읽고 쓸 수 있는 기능도 제공합니다.

이 프로젝트에는 원래 Anthropic, PBC에서 개발한 코드가 포함되어 있으며, 이 저장소 의 MIT 라이선스에 따라 라이선스가 부여되었습니다.

구성 요소

도구

• gdrive_search
  • 설명 : Google Drive에서 파일을 검색합니다.
  • 입력 :
    • query (문자열): 검색 쿼리.
    • pageToken (문자열, 선택 사항): 다음 페이지의 결과에 대한 토큰입니다.
    • pageSize (숫자, 선택 사항): 페이지당 결과 수(최대 100).
  • 출력 : 일치하는 파일의 파일 이름과 MIME 유형을 반환합니다.
• gdrive_read_file
  • 설명 : Google Drive에서 파일의 내용을 읽습니다.
  • 입력 :
    • fileId (문자열): 읽을 파일의 ID입니다.
  • 출력 : 지정된 파일의 내용을 반환합니다.
• gsheets_read
  • 설명 : 범위와 서식에 대한 유연한 옵션을 사용하여 Google 스프레드시트에서 데이터를 읽습니다.
  • 입력 :
    • spreadsheetId (문자열): 읽을 스프레드시트의 ID입니다.
    • ranges (문자열 배열, 선택 사항): A1 표기법 범위의 선택적인 배열(예: ['Sheet1!A1:B10'] ). 지정하지 않으면 전체 시트를 읽습니다.
    • sheetId (숫자, 선택 사항): 읽을 특정 시트 ID입니다. 범위가 지정되지 않으면 첫 번째 시트를 읽습니다.
  • 출력 : 스프레드시트에서 지정된 데이터를 반환합니다.
• gsheets_update_cell
  • 설명 : Google 스프레드시트의 셀 값을 업데이트합니다.
  • 입력 :
    • fileId (문자열): 스프레드시트의 ID입니다.
    • range (문자열): A1 표기법의 셀 범위(예: 'Sheet1!A1' ).
    • value (문자열): 새 셀 값입니다.
  • 출력 : 지정된 셀의 업데이트된 값을 확인합니다.

자원

이 서버는 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 , https://www.googleapis.com/auth/spreadsheets
5. "데스크톱 앱" 애플리케이션 유형에 대한 OAuth 클라이언트 ID를 만듭니다.
6. 클라이언트의 OAuth 키 JSON 파일을 다운로드하세요.
7. 키 파일의 이름을 gcp-oauth.keys.json 으로 바꾸고 GDRIVE_CREDS_DIR 로 지정한 경로(예: /Users/username/.config/mcp-gdrive )에 넣습니다.
8. OAuth 클라이언트 ID와 클라이언트 비밀번호를 기록해 두세요. 이 ID와 비밀번호는 구성 디렉터리와 함께 환경 변수로 제공해야 합니다.

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

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 drive-mcp를 자동으로 설치하려면:

지엑스피1

입증

Google API에 요청하기 전에 브라우저에서 인증하라는 메시지가 표시됩니다. Google Cloud 프로젝트와 동일한 조직의 계정으로 인증해야 합니다.

OAuth 토큰은 GDRIVE_CREDS_DIR 환경 변수에 지정된 디렉토리에 저장됩니다.

데스크톱 앱 사용

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

특허

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