구글 드라이브 서버

Name: Google Drive MCP Server
Author: isaacphi

이 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
- 다른 파일은 원래 형식으로 제공됩니다.

Related MCP server: Google Tasks MCP Server

시작하기

새로운 Google Cloud 프로젝트를 만듭니다.
Google 드라이브 API 활성화
OAuth 동의 화면을 구성합니다 (테스트에는 "내부"가 적합합니다)
OAuth 범위 추가 https://www.googleapis.com/auth/drive.readonly , https://www.googleapis.com/auth/spreadsheets
시트 및 문서와의 상호 작용을 허용하려면 작업 공간의 '사용 가능한 API 및 서비스' 섹션에서 Google Sheets API 와 Google Docs API 도 활성화해야 합니다.
"데스크톱 앱" 애플리케이션 유형에 대한 OAuth 클라이언트 ID를 만듭니다.
클라이언트의 OAuth 키 JSON 파일을 다운로드하세요.
키 파일의 이름을 gcp-oauth.keys.json 으로 바꾸고 GDRIVE_CREDS_DIR 로 지정한 경로(예: /Users/username/.config/mcp-gdrive )에 넣습니다.
OAuth 클라이언트 ID와 클라이언트 비밀번호를 기록해 두세요. 이 ID와 비밀번호는 구성 디렉터리와 함께 환경 변수로 제공해야 합니다.
프로젝트 내에 다음 필드를 포함하는 .env 파일도 설정해야 합니다. 클라이언트 ID와 클라이언트 비밀번호는 Google Cloud Console의 사용자 인증 정보 섹션에서 확인할 수 있습니다.

지엑스피1

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

입증

다음으로 인증 단계를 트리거하려면 node ./dist/index.js 실행해야 합니다.

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

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

인증 프롬프트

데스크톱 앱 사용

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

{ "mcpServers": { "gdrive": { "command": "npx", "args": ["-y", "@isaacphi/mcp-gdrive"], "env": { "CLIENT_ID": "<CLIENT_ID>", "CLIENT_SECRET": "<CLIENT_SECRET>", "GDRIVE_CREDS_DIR": "/path/to/config/directory" } } } }