Google Drive 서버

이 MCP 서버는 Google Drive와 통합되어 파일 목록 조회, 읽기, 검색은 물론 Google Sheets 읽기 및 쓰기 기능을 제공합니다.

이 프로젝트는 Anthropic, PBC가 원래 개발하고 MIT 라이선스로 제공된 코드를 포함합니다. 이 저장소에서 확인할 수 있습니다.

구성 요소

도구

• gdrive_search

  • 설명: Google Drive에서 파일을 검색합니다.

  • 입력:

    • query (string): 검색어.

    • pageToken (string, 선택 사항): 다음 결과 페이지의 토큰.

    • pageSize (number, 선택 사항): 페이지당 결과 수 (최대 100).

  • 출력: 일치하는 파일의 파일 이름과 MIME 유형을 반환합니다.

• gdrive_read_file

  • 설명: Google Drive에서 파일 내용을 읽습니다.

  • 입력:

    • fileId (string): 읽을 파일의 ID.

  • 출력: 지정된 파일의 내용을 반환합니다.

• gsheets_read

  • 설명: 범위 및 서식에 대한 유연한 옵션으로 Google 스프레드시트에서 데이터를 읽습니다.

  • 입력:

    • spreadsheetId (string): 읽을 스프레드시트의 ID.

    • ranges (문자열 배열, 선택 사항): A1 표기법 범위의 선택적 배열 (예: ['Sheet1!A1:B10']). 제공되지 않으면 전체 시트를 읽습니다.

    • sheetId (number, 선택 사항): 읽을 특정 시트 ID. ranges와 함께 제공되지 않으면 첫 번째 시트를 읽습니다.

  • 출력: 스프레드시트에서 지정된 데이터를 반환합니다.

• gsheets_update_cell

  • 설명: Google 스프레드시트에서 셀 값을 업데이트합니다.

  • 입력:

    • fileId (string): 스프레드시트의 ID.

    • range (string): A1 표기법의 셀 범위 (예: 'Sheet1!A1').

    • value (string): 새 셀 값.

  • 출력: 지정된 셀의 업데이트된 값을 확인합니다.

리소스

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

• 파일 (gdrive:///<file_id>)

  • 모든 파일 유형 지원

  • Google Workspace 파일은 자동으로 내보내집니다:

    • 문서 → Markdown

    • 시트 → CSV

    • 프레젠테이션 → 일반 텍스트

    • 그림 → PNG

  • 기타 파일은 원래 형식으로 제공됩니다

Related MCP server: Google Drive server

시작하기

1. 새 Google Cloud 프로젝트 만들기

2. Google Drive API 사용 설정

3. OAuth 동의 화면 구성 ("internal"은 테스트에 적합)

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와 클라이언트 시크릿을 기록해 두세요. 구성 디렉터리와 함께 환경 변수로 제공해야 합니다.

10. 또한 프로젝트 내에 다음 필드가 포함된 .env 파일을 설정해야 합니다. 클라이언트 ID와 클라이언트 시크릿은 Google Cloud Console의 사용자 인증 정보 섹션에서 찾을 수 있습니다.

GDRIVE_CREDS_DIR=/path/to/config/directory
CLIENT_ID=<CLIENT_ID>
CLIENT_SECRET=<CLIENT_SECRET>

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"
      }
    }
  }
}

라이선스

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