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 Spreadsheet 读取数据。
  • 输入:
    • spreadsheetId (字符串): 要读取的电子表格 ID。
    • ranges (字符串数组, 可选): A1 格式范围的可选数组（例如，['Sheet1!A1:B10']）。如果不提供，则读取整个工作表。
    • sheetId (数字, 可选): 要读取的特定工作表 ID。如果未与 ranges 一起提供，则读取第一个工作表。
  • 输出: 返回电子表格中的指定数据。

• gsheets_update_cell

  • 描述: 更新 Google Spreadsheet 中的单元格值。
  • 输入:
    • 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. 为应用程序类型“桌面应用”创建一个 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 安装

要通过 Smithery 自动安装 Claude Desktop 的 drive-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 文件。