구글 드라이브 서버

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

지엑스피1

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

입증

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

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

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

데스크톱 앱 사용

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

특허

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