ORCA Drive MCP

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

작은 Google Apps Script 웹 앱을 통해 Google Drive를 읽으므로 Google Cloud Console이나 서비스 계정이 필요하지 않습니다.

도구

Related MCP server: mcp-server-drive

1. Apps Script 백엔드 만들기

1. https://script.google.com에 접속하여 새 프로젝트를 만듭니다.

2. 자리 표시자 코드를 삭제하고 apps-script.js의 내용을 붙여넣습니다.

3. 배포 > 새 배포를 클릭합니다:

   • 유형: 웹 앱

   • 실행 대상: 나

   • 액세스 권한: 모두

4. 배포를 클릭하고 스크립트를 승인합니다 (Drive에 대한 액세스를 허용).

5. /exec로 끝나는 웹 앱 URL을 복사합니다 (예: https://script.google.com/macros/s/AKfycb.../exec).

브라우저에서 /exec URL을 한 번 열고 스크립트가 Drive 파일에 액세스할 수 있도록 승인합니다.

2. 환경 변수 구성하기

.env.example을 .env로 복사하고 (로컬 개발) Vercel에서 동일한 값을 설정합니다 (프로젝트 > 설정 > 환경 변수):

3. 로컬에서 실행하기

npm install
vercel dev

MCP Inspector로 테스트합니다:

npx @modelcontextprotocol/inspector

전송 방식 Streamable HTTP와 URL http://localhost:3000/을 사용합니다.

4. Vercel에 배포하기

vercel --prod

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

5. 클라이언트 연결하기

Claude Desktop (claude_desktop_config.json):

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