AI导哈

Google Drive文件管理服务

该服务提供与Google Drive的集成，支持文件列表、读取、搜索以及Google Sheets的读写操作，适用于需要高效管理云端文件的场景。

  • by isaacphi
  • TypeScript
  • 本地部署
  • 282 星标
  • 更新于
在 GitHub 查看 isaacphi/mcp-gdrive

使用说明

谷歌云端硬盘服务器

此MCP服务器与Google Drive集成，允许列出、读取和搜索文件，以及读取和写入Google表格。

该项目包括最初由Anthropic，PBC开发的代码，根据MIT许可证从 此回购.

组件

工具

  • gdrive_search

    • 描述：在Google Drive中搜索文件。
    • 输入:
      • query （string）：搜索查询。
      • pageToken （字符串，可选）：下一页结果的标记。
      • pageSize （数字，可选）：每页结果数（最多100个）。
    • 输出：返回匹配文件的文件名和MIME类型。

  • gdrive_read_file

    • 描述：从Google云端硬盘读取文件内容。
    • 输入:
      • fileId （string）：要读取的文件的ID。
    • 输出：返回指定文件的内容。

  • gsheets_read

    • 描述：从谷歌电子表格中读取数据，范围和格式选项灵活。
    • 输入:
      • spreadsheetId （string）：要读取的电子表格的ID。
      • ranges （字符串数组，可选）：A1表示法范围的可选数组（例如。， ['Sheet1!A1:B10']).如果没有提供，请读取整张表。
      • sheetId （数字，可选）：要读取的特定纸张ID。如果没有提供范围，则读取第一页。
    • 输出：从电子表格中返回指定的数据。

  • gsheets_update_cell

    • 描述：更新Google电子表格中的单元格值。
    • 输入:
      • fileId （string）：电子表格的ID。
      • range （string）：A1表示法中的单元格范围（例如。， 'Sheet1!A1').
      • value （string）：新单元格值。
    • 输出：确认指定单元格中的更新值。

资源

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

  • 文件 (gdrive:///<file_id>)
    • 支持所有文件类型
    • Google Workspace文件会自动导出：
      • Docs → 降价
      • 表格→ CSV
      • 演示→ 纯文本
      • 图纸→ PNG
    • 其他文件以其原生格式提供

入门

  1. 创建新的Google Cloud项目
  2. 启用Google Drive API
  3. 配置OAuth同意屏幕 （“内部”适合测试）
  4. 添加OAuth作用域 https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/spreadsheets
  5. 为了允许与工作表和文档进行交互，您还需要启用 谷歌网页API 和 谷歌文档API 在您的工作区启用API和服务部分。
  6. 创建OAuth客户端ID 适用于应用程序类型“桌面应用程序”
  7. 下载客户端OAuth密钥的JSON文件
  8. 将密钥文件重命名为 gcp-oauth.keys.json 并放置到您指定的路径中 GDRIVE_CREDS_DIR （即。 /Users/username/.config/mcp-gdrive)
  9. 记下您的OAuth客户端ID和客户端密码。它们必须作为环境变量与配置目录一起提供。
  10. 您还需要在项目中设置一个.env文件，其中包含以下字段。您可以在Google Cloud控制台的凭据部分找到客户端ID和客户端密码。
GDRIVE_CREDS_DIR=/path/to/config/directory
CLIENT_ID=<CLIENT_ID>
CLIENT_SECRET=<CLIENT_SECRET>

确保使用以下任一方法构建服务器 npm run build 或 npm run watch.

认证

接下来，你需要跑步 node ./dist/index.js 触发身份验证步骤

系统将提示您使用浏览器进行身份验证。您必须使用与您的Google Cloud项目所在组织相同的帐户进行身份验证。

您的OAuth令牌保存在由 GDRIVE_CREDS_DIR 环境变量。

使用桌面应用程序

要将此服务器与桌面应用程序集成，请将以下内容添加到应用程序的服务器配置中：

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

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。

相关 MCP