Drive File Browser MCP

AI 어시스턴트(Claude Desktop, Claude Code, Cursor, opencode 또는 모든 MCP 클라이언트)가 Google Drive 폴더의 파일을 탐색, 검색, 읽을 수 있게 해주는 Model Context Protocol(MCP) 서버입니다.

두 가지 모드로 실행됩니다:

• 로컬(stdio) — 데스크톱 MCP 클라이언트용

• 원격(HTTP, Streamable) — Vercel에 배포: https://drive-file-browser-mcp.vercel.app/api/mcp

제공 도구

Related MCP server: mcp-google-gdrive

원격 배포(Vercel)

서버는 다음 주소에서 실행 중입니다:

https://drive-file-browser-mcp.vercel.app/api/mcp

상태 비저장(stateless) Streamable HTTP 전송을 사용하므로 원격 HTTP 서버를 지원하는 모든 MCP 클라이언트에서 작동합니다. 엔드포인트는 Bearer API 키로 보호됩니다.

클라이언트 연결

Claude Desktop / Claude Code(claude_desktop_config.json 또는 .mcp.json):

{
  "mcpServers": {
    "drive-browser": {
      "type": "http",
      "url": "https://drive-file-browser-mcp.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

모든 HTTP 클라이언트 — Content-Type: application/json, Accept: application/json, text/event-stream, Authorization: Bearer <YOUR_API_KEY> 헤더와 함께 JSON-RPC를 POST로 전송:

curl -X POST https://drive-file-browser-mcp.vercel.app/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

헬스 체크(인증 불필요): GET https://drive-file-browser-mcp.vercel.app/api/health

자체 인스턴스 배포

1. 이 저장소를 포크/클론한 후:

npm install
npm i -g vercel
vercel login
vercel link --yes
# env vars:
echo "<your-api-key>" | vercel env add MCP_API_KEY production
echo "<your-drive-folder-id>" | vercel env add DRIVE_ROOT_FOLDER_ID production
echo "<service-account-json-contents>" | vercel env add GOOGLE_SERVICE_ACCOUNT_JSON production
vercel deploy --prod --yes

2. Google 서비스 계정 JSON을 생성하고(아래 참조) Drive 폴더를 해당 client_email과 공유합니다.

환경 변수(Vercel)

Vercel 대시보드에서 관리: Project → Settings → Environment Variables.

로컬 설정(stdio 모드)

1. Google 서비스 계정 생성

1. Google Cloud Console로 이동하여 프로젝트를 생성(또는 선택)합니다.

2. Google Drive API를 사용 설정합니다(APIs & Services → Library → "Google Drive API" 검색 → Enable).

3. APIs & Services → Credentials → Create Credentials → Service account로 이동합니다.

4. 서비스 계정을 열고 Keys 탭 → Add key → Create new key → JSON을 선택합니다. .json 키 파일이 다운로드됩니다.

5. Drive 폴더를 서비스 계정 이메일과 공유합니다(JSON 파일에서 client_email로 확인 가능, 형식: xxx@xxx.iam.gserviceaccount.com) — Drive에서 폴더를 마우스 오른쪽 버튼으로 클릭 → 공유 → 해당 이메일 입력 → 뷰어 권한 부여.

2. 설치 및 빌드

git clone https://github.com/ashrafur02-sys/drive-file-browser-mcp.git
cd drive-file-browser-mcp
npm install
npm run build

3. 구성

환경 변수 설정(또는 .env.example을 .env로 복사 — 참고: .env 파일은 자동으로 로드되지 않으므로 MCP 클라이언트 구성에 실제 환경 변수를 설정해야 합니다. 또는 GOOGLE_SERVICE_ACCOUNT_JSON을 파일 경로로 지정):

MCP 클라이언트에서 사용

클라이언트의 MCP 구성에 다음을 추가합니다:

Claude Desktop(claude_desktop_config.json):

{
  "mcpServers": {
    "drive-browser": {
      "command": "node",
      "args": ["/absolute/path/to/drive-file-browser-mcp/dist/src/index.js"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_JSON": "/absolute/path/to/service-account.json",
        "DRIVE_ROOT_FOLDER_ID": "1TG4ssc_z0FgG2snDapoR_SRu3y16Wxm5"
      }
    }
  }
}

Claude Code / opencode:

{
  "mcpServers": {
    "drive-browser": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/drive-file-browser-mcp/dist/src/index.js"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_JSON": "/absolute/path/to/service-account.json",
        "DRIVE_ROOT_FOLDER_ID": "1TG4ssc_z0FgG2snDapoR_SRu3y16Wxm5"
      }
    }
  }
}

연결 후 어시스턴트에게 다음과 같이 요청할 수 있습니다:

• "Drive 폴더의 파일 목록을 보여줘"

• "보도자료 프레젠테이션을 검색해줘"

• "기업 커뮤니케이션 파일을 읽어줘"

• "ID가 ...인 파일의 정보를 가져와줘"

보안 참고 사항

• 서버는 읽기 전용 Drive 범위(drive.readonly)를 사용합니다.

• 서비스 계정 키를 커밋하지 마세요. 기본적으로 .gitignore에 포함되어 있습니다.

• 키 파일을 공유한 사람은 서비스 계정이 볼 수 있는 모든 데이터에 읽기 권한을 갖게 됩니다 — 저장소를 공유하지 말고 키를 공유하지 마세요.

라이선스

MIT