Felores Gdrive MCP Server

🚀 Google Drive MCP サーバー

このサーバーは、強力なモデルコンテキストプロトコル（MCP）を備え、Google Driveとシームレスに統合することができます。AIモデルは、Google Drive内のファイルを検索、一覧表示、読み取りすることが可能です。

🚀 クイックスタート

前提条件

• Node.js（v16以上）
• npm または yarn
• Google Cloudプロジェクト
• Google Workspaceまたは個人のGoogleアカウント

Google Cloudの詳細設定

1. Google Cloudプロジェクトの作成

   • Google Cloudコンソールにアクセスします。
   • 「新しいプロジェクト」をクリックします。
   • プロジェクト名（例：「MCP GDrive Server」）を入力します。
   • 「作成」をクリックし、プロジェクトの作成が完了するのを待ち、選択します。

2. Google Drive APIの有効化

   • APIライブラリに移動します。
   • 「Google Drive API」を検索し、「有効化」をクリックします。

3. OAuth 2.0クライアントIDの設定

   • 認証情報のセクションにアクセスします。
   • 「認証情報を追加」をクリックし、「OAuth 2.0クライアントID」を選択します。
   • プロジェクトの詳細を設定し、リダイレクトURI（例：urn:ietf:wg:oauth:2.0:oob）を指定します。
   • 生成されたJSONキーファイルを取得し、gcp - oauth.jsonと名前を付けます。

4. 依存関係のインストール

   • プロジェクトのルートディレクトリで以下のコマンドを実行します。

     npm install @google/drive --save
     

✨ 主な機能

ツール

1. gdrive_search

Google Drive内で強力な全文検索機能を使ってファイルを検索します。

• 入力：

  {
    "query": "string (検索クエリ)"
  }
  

• 出力：以下の情報を含むファイルリスト
  • ファイル名
  • MIMEタイプ
  • ファイルID
  • 最終更新日時
  • ファイルサイズ

2. gdrive_read_file

Google DriveのファイルIDを使用して直接ファイル内容を読み取ります。

• 入力：

  {
    "file_id": "string (Google DriveファイルID)"
  }
  

• 出力：適切な形式に変換されたファイル内容

ファイル形式の自動処理

サーバーは、様々なGoogle Workspaceファイルタイプを自動的に処理します。

• 📝 Google Docs → Markdown
• 📊 Google Sheets → CSV
• 📊 Google Presentations → テキスト
• 🎨 Google Drawings → PNG
• 📄 テキスト/JSONファイル → UTF - 8テキスト
• 📦 その他のファイル → Base64エンコード

📦 インストール

リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/your-repository/mcp-gdrive.git
cd mcp-gdrive
npm install

🔑 認証

以下の手順で認証を設定して実行します。

1. config.jsonファイルを作成し、Google CloudプロジェクトIDとキーファイルのパスを追加します。

   {
     "projectId": "your-project-id",
     "keyFile": "path/to/gcp-oauth.json"
   }
   

2. ターミナルで以下のコマンドを実行して認証します。

   npm run authenticate
   

   これにより、OAuth 2.0の認証フローが開始され、必要なアクセストークンが取得されます。

💻 使用例

基本的な使用法

ファイル検索の例

const { searchFiles } = require('./src/drive');

async function main() {
    const query = "quarterly report";
    const result = await searchFiles(query);
    console.log(result.files);
}

main().catch(console.error);

ファイル内容の読み取り例

const { readFile } = require('./src/drive');

async function main() {
    const fileId = "your-file-id";
    const contents = await readFile(fileId);
    console.log(contents);
}

main().catch(console.error);

📄 ライセンス

このMCPサーバーは、MIT Licenseの下でライセンスされています。詳細はLICENSEファイルを参照してください。

📚 ドキュメント

トラブルシューティング

問題が発生した場合は、以下のことを確認してください。

1. Google Cloudプロジェクトの設定を検証します。
2. すべての必要なOAuthスコープが有効になっていることを確認します。
3. 認証情報がcredentialsディレクトリに正しく配置されていることを確認します。
4. ファイルの権限とアクセス権を検証します。

追加リソース

• Google Drive APIドキュメント
• OAuth 2.0デスクトップアプリ
• モデルコンテキストプロトコルドキュメント