구글 드라이브 서버

이 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: manus-mcp

시작하기

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 환경 변수에 지정된 디렉토리에 저장됩니다.

데스크톱 앱 사용

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

{
  "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 파일을 참조하세요.