McpGoogleDrive

McpGoogleDrive

项目简介

McpGoogleDrive 是一个与 Google Drive 交互的 Spring Boot 应用。它提供了一组 RESTful API 端点，用于执行各种 Google Drive 操作，例如列出文件、获取文件详情、搜索文件、创建文件夹，以及将文件下载为 PDF。

功能

• 列出 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 文件。