g-command

Google Drive 브라우저 및 Obsidian 동기화 도구, Claude Code용 MCP 서버.

하나의 패키지에 두 가지 구성 요소:

1. Obsidian 플러그인 — Docs(→ 마크다운), Sheets(→ CSV) 및 기타 파일을 보관함에 동기화하는 사이드바 Drive 브라우저

2. MCP 서버 — Claude Code가 Drive를 검색하고, 보관함 노트를 읽고, Drive 파일을 보관함으로 가져올 수 있게 함

로컬 마운트(.gdoc, .gsheet)의 Google Drive 파일은 JSON 포인터입니다. 실제 콘텐츠는 API 뒤에 있습니다. 두 구성 요소 모두 rclone을 사용하여 이 격차를 해소합니다.

기능

• 검색 Drive(파일 이름으로), 보관함(퍼지 검색), 또는 둘 다

• 읽기 gdrive:// 및 vault:// 리소스를 통해 모든 Drive 파일 또는 보관함 노트

• 가져오기 Drive 파일을 보관함으로 — 다운로드, 변환(Docs → 마크다운, Sheets → CSV), 한 번의 호출로 동기화 상태 업데이트

• 섹션 필터 — 제목 이름 또는 인덱스로 특정 문서 섹션 추출

• 보관함 검색 — 시스템에 등록된 모든 Obsidian 보관함 자동 감지

• 범위: drive.readonly — Google Drive에 대한 쓰기 권한 없음

Related MCP server: manus-mcp

필수 조건

• Node.js 18+

• rclone (GCP OAuth 설정 대체)

• Claude Code

설정

Obsidian 플러그인

1. rclone 설치 (macOS에서는 brew install rclone)

2. Obsidian에 플러그인 설치

3. g-command 설정 탭을 열고 연결 클릭

4. 열리는 브라우저 창에서 Google로 로그인

완료되었습니다. 플러그인은 읽기 전용 rclone 원격을 생성하고 연결을 확인합니다.

MCP 서버 (Claude Code용)

./setup.sh

스크립트가 MCP 서버를 빌드하고 Claude Code에 등록합니다. rclone이 아직 구성되지 않은 경우 인증 과정을 안내합니다.

rclone 원격 이름이 이미 gdrive가 아닌 다른 경우:

GDRIVE_RCLONE_REMOTE=my-remote ./setup.sh

수동 MCP 설정

1. brew install rclone (설치되지 않은 경우)

2. cd src/gdrive && npm install && npm run build

3. claude mcp add vault node /absolute/path/to/src/gdrive/dist/index.js

확인

Claude Code에서 /mcp 실행 — vault가 연결된 상태로 표시되어야 합니다. 그런 다음 파일 이름으로 문서를 검색해 보세요.

보안 참고 사항

• 이 서버는 자격 증명을 저장하지 않습니다. 인증은 전적으로 rclone이 관리합니다.

• rclone 토큰은 ~/.config/rclone/rclone.conf에 저장됩니다.

• drive.readonly 범위는 토큰이 손상될 경우 피해 범위를 제한합니다.

• 서버는 단일 감사 가능한 TypeScript 파일입니다.

구성

참고 자료

• rclone Google Drive 문서

• Claude Code MCP 설정