Google Drive文件管理服务

该服务通过集成Google Drive API,提供文件搜索、读取、Google Sheets读写等功能,适用于需要高效管理云端文件的场景。

  • by rishipradeep-think41
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 rishipradeep-think41/drive-mcp

使用说明

谷歌云端硬盘服务器

此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. 创建OAuth客户端ID 适用于应用程序类型“桌面应用程序”
  6. 下载客户端OAuth密钥的JSON文件
  7. 将密钥文件重命名为 gcp-oauth.keys.json 并放置到您指定的路径中 GDRIVE_CREDS_DIR (即。 /Users/username/.config/mcp-gdrive)
  8. 记下您的OAuth客户端ID和客户端密码。它们必须作为环境变量与配置目录一起提供。

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

通过Smithery安装

通过以下方式自动安装Claude Desktop的mcp驱动器 史密瑟里:

npx -y @smithery/cli install @rishipradeep-think41/drive-mcp --client claude

认证

在向Google的API发出请求之前,系统会提示您使用浏览器进行身份验证。您必须使用与您的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文件。