MCP Gdrive

🚀 Google Drive 服务器

本 MCP 服务器与 Google Drive 深度集成，具备强大功能。它能对 Google Drive 中的文件进行列出、读取和搜索操作，还能灵活地对 Google 表格进行读写操作，为文件管理和表格处理提供了便捷的解决方案。

该项目包含由 Anthropic, PBC 最初开发的代码，遵循 MIT License 许可协议，代码源自 这个仓库。

🚀 快速开始

若要启动此服务器，可按以下步骤操作：

1. 创建项目：登录 Google Cloud Console，创建一个新的项目。
2. 启用 API：在 Google Cloud Console 中启用 Google Drive API 以及其他必要的 API。
3. 创建 OAuth 应用：对 OAuth 进行配置，以获取用户的授权。
4. 设置环境变量：配置 CLIENT_ID、CLIENT_SECRET 和 GDRIVE_CREDENTIALS_DIR 这三个环境变量。
5. 运行命令：使用指定的命令行参数来启动服务器。

✨ 主要特性

工具

• gdrive_search
  • 描述：可在 Google Drive 中进行文件搜索。
  • 输入：
    • query（字符串）：搜索的查询内容。
    • pageToken（字符串，可选）：用于获取下一页结果的令牌。
    • pageSize（数字，可选）：每页显示的结果数量，最多为 100 条。
  • 输出：返回匹配文件的名称和 MIME 类型。
• gdrive_read_file
  • 描述：从 Google Drive 中读取文件的内容。
  • 输入：
    • fileId（字符串）：要读取的文件的 ID。
  • 输出：返回指定文件的内容。
• gsheets_read
  • 描述：可以带有灵活范围和格式选项地从 Google 表格中读取数据。
  • 输入：
    • spreadsheetId（字符串）：要读取的表格的 ID。
    • ranges（字符串数组，可选）：可选的 A1 格式范围数组，例如 [ 'Sheet1!A1:B10' ]。若未提供，则读取整个表格。
    • sheetId（数字，可选）：特定要读取的工作表的 ID。若未提供且未指定范围，则读取第一张工作表。
  • 输出：返回指定的数据。
• gsheets_update_cell
  • 描述：更新 Google 表格中的单元格的值。
  • 输入：
    • fileId（字符串）：表格的 ID。
    • range（字符串）：单元格的范围，采用 A1 格式，例如 'Sheet1!A1'。
    • value（字符串）：新的单元格的值。
  • 输出：确认指定的单元格已更新。

资源

该服务器提供对 Google Drive 文件的访问：

• 文件 (gdrive:///<file_id>)
  • 支持所有类型的文件。
  • 包含处理不同文件类型（如文本、图片等）的说明。

💻 使用示例

基础用法

以下是一个示例配置，展示了如何配置环境变量和启动命令：

{
  "gdrive": {
    "command": "npx",
    "args": ["-y", "@isaacphi/mcp-gdrive"],
    "env": {
      "CLIENT_ID": "<CLIENT_ID>",
      "CLIENT_SECRET": "<CLIENT_SECRET>",
      "GDRIVE_CREDENTIALS_DIR": "/path/to/config/directory"
    }
  }
}

📄 许可证

此 MCP 服务器遵循 MIT License 进行分发。这意味着您可以自由地使用、修改和分发该软件，但需遵守 MIT License 的相关条款。更多详细信息，请参阅项目存储库中的 LICENSE 文件。

通过以上内容，您能够顺利配置并运行一个集成 Google Drive 功能的 MCP 服务器，用于高效的文件管理和表格操作。