McpGoogleDrive

McpGoogleDrive

プロジェクトの説明

McpGoogleDrive は、Google Drive と連携する Spring Boot アプリケーションです。ファイルの一覧表示、ファイルの詳細取得、ファイル検索、フォルダー作成、ファイルの PDF としてのダウンロードなど、Google Drive 上でさまざまな操作を行うための RESTful API エンドポイントを提供します。

機能

• Google Drive 内のファイルを一覧表示
• 特定のファイルの詳細を取得
• ファイル名でファイルを検索
• Google Drive 内にフォルダーを作成
• ファイルを PDF としてダウンロード

前提条件

• Java 17 以上
• Gradle
• Google Cloud Platform アカウント
• Google Drive API が有効になっていること
• サービスアカウントの認証情報を含む JSON ファイル

インストール

1. リポジトリをクローンします。

   git clone https://github.com/achrafhardizi/McpGoogleDrive.git
   cd McpGoogleDrive
   

2. Gradle を使ってプロジェクトをビルドします。

   ./gradlew build
   

設定

1. Google Drive API の認証情報を設定します。

   • Google Cloud Console にアクセスします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • プロジェクトで Google Drive API を有効にします。
   • サービスアカウントを作成し、JSON キーファイルをダウンロードします。
   • JSON キーファイルを src/main/resources/credentials ディレクトリに配置します。

2. アプリケーションのプロパティを設定します。

   • src/main/resources/application.properties ファイルを開きます。
   • google.service.account.key プロパティに、サービスアカウントのキーファイルのパスを設定します。

     google.service.account.key=credentials/service-account-key.json
     

使用方法

アプリケーションは、以下の API エンドポイントを提供します。

• ファイルの一覧表示：GET /api/drive/files

  • クエリパラメーター：
    • pageSize（省略可）：一覧表示するファイルの数（デフォルト：10）
  • リクエスト例：

    curl -X GET "http://localhost:8080/api/drive/files?pageSize=5"
    

• ファイルの詳細取得：GET /api/drive/files/{fileId}

  • パスパラメーター：
    • fileId：ファイルの ID
  • リクエスト例：

    curl -X GET "http://localhost:8080/api/drive/files/{fileId}"
    

• ファイルの検索：GET /api/drive/search

  • クエリパラメーター：
    • query：検索クエリ
  • リクエスト例：

    curl -X GET "http://localhost:8080/api/drive/search?query=example"
    

• フォルダーの作成：POST /api/drive/folders

  • クエリパラメーター：
    • folderName：作成するフォルダーの名前
  • リクエスト例：

    curl -X POST "http://localhost:8080/api/drive/folders?folderName=NewFolder"
    

• ファイルを PDF としてダウンロード：GET /api/drive/files/{fileId}/pdf

  • パスパラメーター：
    • fileId：ファイルの ID
  • リクエスト例：

    curl -X GET "http://localhost:8080/api/drive/files/{fileId}/pdf" -o file.pdf
    

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。