ORCA Drive SA MCP

Streamable HTTP를 통해 Google Drive 폴더를 노출하는 Model Context Protocol(MCP) 서버로, Vercel 서버리스 함수로 배포됩니다.

Google 서비스 계정(Drive API v3, 읽기 전용 범위)을 통해 Google Drive를 읽으므로 Apps Script 웹 앱이 필요하지 않습니다.

도구

Related MCP server: Google Drive MCP Server

1. Google 서비스 계정 만들기

1. https://console.cloud.google.com로 이동하여 프로젝트를 생성(또는 선택)합니다.

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

3. 서비스 계정을 생성합니다:

   • APIs & Services → Credentials → Create credentials → Service account.

   • 이름을 지정하고 Create and continue를 클릭한 다음 Done을 클릭합니다.

4. 키를 생성합니다:

   • 서비스 계정을 열고 → Keys → Add key → Create new key → JSON을 선택합니다.

   • JSON 키 파일을 다운로드합니다.

5. 서비스 계정 이메일을 복사합니다(예: orca-drive@my-project.iam.gserviceaccount.com).

6. 해당 이메일로 대상 Drive 폴더를 공유합니다(Drive에서 폴더를 마우스 오른쪽 버튼으로 클릭 → Share → 이메일 붙여넣기 → Viewer).

서비스 계정과 공유된 파일/폴더만 액세스할 수 있습니다.

2. 환경 변수 구성

.env.example을 .env로 복사하고(로컬 개발) Vercel에서도 동일한 값을 설정합니다(Project > Settings > Environment Variables):

3. 로컬에서 실행

npm install
vercel dev

전송 방식 Streamable HTTP와 URL http://localhost:3000/을 사용하여 MCP Inspector(npx @modelcontextprotocol/inspector)로 테스트합니다.

4. Vercel에 배포

vercel --prod

엔드포인트는 https://<project>.vercel.app/이 됩니다.

5. 클라이언트 연결

Claude Desktop(claude_desktop_config.json):

{
  "mcpServers": {
    "orca-drive-sa": {
      "type": "http",
      "url": "https://<project>.vercel.app/"
    }
  }
}