Google Drive server

注意
此 MCP 服务改编自 modelcontextprotocol/servers (src/gdrive)，并经过更新和修改以满足定制需求。

此 MCP 服务是对 modelcontextprotocol/servers (src/gdrive) 进行更新和修改后的版本。'

---

---

---

Google Drive 服务

此 MCP 服务与 Google Drive 集成，可列出、读取和搜索文件。

组件

工具

• search
  • 搜索 Google Drive 中的文件
  • 输入：query（字符串）：搜索查询
  • 返回匹配文件的名称和 MIME 类型

资源

此服务可访问 Google Drive 文件：

• 文件（gdrive:///<file_id>）
  • 支持所有文件类型
  • Google Workspace 文件会自动导出：
    • Docs → Markdown
    • Sheets → CSV
    • Presentations → 纯文本
    • Drawings → PNG
  • 其他文件将以其原生格式提供

入门

1. 创建新的 Google Cloud 项目
2. 启用 Google Drive API
3. 配置 OAuth 同意屏幕（测试时使用“内部”即可）
4. 添加 OAuth 范围 https://www.googleapis.com/auth/drive.readonly
5. 创建 OAuth 客户端 ID，应用类型选择“Desktop App”
6. 下载客户端的 OAuth 密钥 JSON 文件
7. 将密钥文件重命名为 gcp-oauth.keys.json，并放在此仓库的根目录中（即 servers/gcp-oauth.keys.json）

请确保使用 npm run build 或 npm run watch 构建服务。

身份验证

要进行身份验证并保存凭据：

1. 使用 auth 参数运行服务：node ./dist auth
2. 这将在系统浏览器中打开身份验证流程
3. 完成身份验证流程
4. 凭据将保存在此仓库的根目录中（即 servers/.gdrive-server-credentials.json）

在桌面应用中使用

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

Docker

身份验证：

假设你已完成在 Google Cloud 上设置 OAuth 应用，现在可以使用以下命令对服务进行身份验证。请将 /path/to/gcp-oauth.keys.json 替换为 OAuth 密钥文件的路径：

docker run -i --rm --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json -v mcp-gdrive:/gdrive-server -e GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json -e "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json" -p 3000:3000 mcp/gdrive auth

命令会打印一个需要在浏览器中打开的网址。在浏览器中打开该网址并完成身份验证流程。凭据将保存在 mcp-gdrive 卷中。

完成身份验证后，你可以在应用的服务配置中使用此服务：

{
  "mcpServers": {
    "gdrive": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-gdrive:/gdrive-server",
        "-e",
        "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
        "mcp/gdrive"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gdrive"]
    }
  }
}

在 VS Code 中使用

如需快速安装，请使用以下一键安装按钮之一。

如需手动安装，请将以下 JSON 代码块添加到 VS Code 的用户设置（JSON）文件中。按下 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 即可完成操作。

也可以将其添加到工作区中名为 .vscode/mcp.json 的文件，以便与他人共享配置。

请注意，.vscode/mcp.json 文件中不需要 mcp 键。

NPX

{
  "mcp": {
    "servers": {
      "gdrive": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-gdrive"],
        "env": {
          "GDRIVE_CREDENTIALS_PATH": "/path/to/.gdrive-server-credentials.json"
        }
      }
    }
  }
}

Docker

{
  "mcp": {
    "servers": {
      "gdrive": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-v",
          "mcp-gdrive:/gdrive-server",
          "-e",
          "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
          "mcp/gdrive"
        ]
      }
    }
  }
}

许可证

此 MCP 服务采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情请参阅项目仓库中的 LICENSE 文件。