Google Drive 服务器

此MCP服务器与Google Drive集成，允许列出、读取和搜索文件，以及读写Google Sheets的能力。

该项目包括由Anthropic, PBC最初开发的代码，并根据MIT许可从这个仓库获得授权。

组件

工具

• 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>)
  • 支持所有文件类型
  • Google Workspace文件会自动导出：
    • 文档 → Markdown
    • 表格 → 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和服务部分中启用 Google Sheets API 和 Google Docs 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 Console的凭据部分找到客户端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文件。 </中文翻译>