Google Drive server

Google Drive 服务

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

组件

工具

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

资源

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

• 文件（gdrive:///<file_id>）
  • 支持所有文件类型
  • Google Workspace 文件会自动导出：
    • 文档 → Markdown
    • 表格 → CSV
    • 演示文稿 → 纯文本
    • 绘图 → PNG
  • 其他文件将以其原生格式提供

开始使用

1. 创建新的 Google Cloud 项目
2. 启用 Google Drive API
3. 配置 OAuth 同意屏幕（测试时使用“internal”即可）
4. 添加 OAuth 范围 https://www.googleapis.com/auth/drive.readonly
5. 为应用类型“Desktop App”创建 OAuth 客户端 ID
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

该命令会输出一个需要在浏览器中打开的 URL。请在浏览器中打开此 URL 并完成身份验证流程。凭据将保存在 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"
      ]
    }
  }
}

许可证

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