MCP Gdrive Server

🚀 Google Drive サーバー

この MCP サーバーは Google Drive と統合されており、ファイルの一覧表示、読み取り、検索が可能です。

✨ 主な機能

ツール

• search
  • Google Drive 内のファイルを検索します。
  • 入力：query（文字列）：検索クエリ
  • 一致するファイルの名前と MIME タイプを返します。

リソース

サーバーは Google Drive のファイルへのアクセスを提供します。

• Files（gdrive:///<file_id>）
  • すべてのファイルタイプをサポートします。
  • Google Workspace ファイルを自動的にエクスポートします。
    • ドキュメント → Markdown
    • スプレッドシート → CSV
    • プレゼンテーション → 純テキスト
    • 図面 → PNG
  • その他のファイルはネイティブ形式で提供されます。

🚀 クイックスタート

セットアップ手順

1. 新しい Google Cloud プロジェクトを作成
2. Google Drive API を有効にする
3. OAuth 同意画面を設定（テスト時は「内部」で構いません）
4. OAuth スコープ https://www.googleapis.com/auth/drive.readonly を追加します。
5. アプリケーションタイプ「デスクトップアプリ」用の OAuth クライアント ID を作成
6. クライアントの OAuth キーファイル JSON ファイルをダウンロードします。
7. キーファイルを gcp-oauth.keys.json にリネームし、現在のリポジトリのルートディレクトリに配置します（例：servers/gcp-oauth.keys.json）

npm run build または npm run watch を使用してビルドすることを確認してください。

認証

認証を行い、資格情報を保存するには：

1. auth パラメータを使用してサーバーを実行します：node ./dist auth
2. ブラウザのシステムセッションで認証フローを開きます。
3. 認証プロセスを完了します。
4. 資格情報は現在のリポジトリのルートディレクトリに保存されます（例：servers/.gdrive-server-credentials.json）

デスクトップアプリとの統合

このサーバーをデスクトップアプリで使用するには、アプリのサーバー設定に追加します。

Docker

認証： Google Cloud 上で OAuth アプリの設定を完了したと仮定して、以下のコマンドを使用してサーバーを認証できます。/path/to/gcp-oauth.keys.json をキーファイルの実際のパスに置き換えてください。

docker run -i --rm --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json -v mcp-gdrive:/gdrive-server -e GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json -e "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json" -p 3000:3000 mcp/gdrive auth

コマンドはブラウザで開く URL を出力します。ブラウザで認証フローを完了してください。資格情報は mcp-gdrive ボリュームに保存されます。

認証が成功したら、アプリのサーバー設定で以下の内容を使用できます。

{
  "mcpServers": {
    "gdrive": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "mcp-gdrive:/gdrive-server", "-e", "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json", "mcp/gdrive"]
    }
  }
}

npm

npm でサーバーを実行するには：

npm start

直接実行

JavaScript ファイルを直接実行することもできます。

node dist/index.js

📄 ライセンス

詳細については、プロジェクトのライセンスファイルを参照してください。

🔗 連絡先

何か質問がある場合は、以下の方法で連絡してください。

• メール：your.email@example.com
• GitHub リポジトリ：github.com/username/repo