mcp/gdrive

Google Drive 服务器

镜像概述和主要用途

此MCP服务器集成Google Drive，提供文件的列出、读取和搜索功能，允许应用程序通过统一接口访问Google Drive中的文件资源。

核心功能和特性

组件

工具

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

资源

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

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

使用场景和适用范围

适用于需要集成Google Drive文件管理功能的应用程序，可用于开发支持Google Drive文件浏览、搜索和读取的桌面或服务器应用。

详细使用方法和配置说明

快速开始

1. https://console.cloud.google.com/projectcreate
2. https://console.cloud.google.com/workspace-api/products
3. https://console.cloud.google.com/apis/credentials/consent%EF%BC%88%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83%E5%8F%AF%E9%80%89%E6%8B%A9%22internal%22%EF%BC%89
4. 添加OAuth权限范围 https://www.googleapis.com/auth/drive.readonly
5. https://console.cloud.google.com/apis/credentials/oauthclient%EF%BC%8C%E5%BA%94%E7%94%A8%E7%B1%BB%E5%9E%8B%E9%80%89%E6%8B%A9%22Desktop 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容器内认证，将/path/to/gcp-oauth.keys.json替换为您的OAuth密钥文件路径：

bash
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 docker.xuanyuan.run/mcp/gdrive auth

命令将输出浏览器中打开的URL，完成认证后，凭证将保存在mcp-gdrive卷中。

应用配置

认证完成后，在应用的服务器配置中添加：

json
{
  "mcpServers": {
    "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文件。