Google Drive文件管理服务器

一个与Google Drive集成的服务器,支持文件列表、读取和搜索功能,适用于需要高效管理云端文件的场景。

  • by mikegcoleman
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 mikegcoleman/google-drive-mcp

使用说明

Google Drive MCP服务器

此MCP服务器与Google Drive集成,允许列出、读取和搜索文件。

归因:此项目基于Google Drive MCP服务器 模型上下文协议/服务器已存档,最初由中国人民银行Anthropic开发。根据MIT许可证获得许可。

组件

工具

  • 搜索
    • 在Google云端硬盘中搜索文件
    • 输入: query (string):搜索查询
    • 返回匹配文件的文件名和MIME类型

资源

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

  • 文件 (gdrive:///<file_id>)
    • 支持所有文件类型
    • Google Workspace文件会自动导出:
      • Docs → 降价
      • 表格→ CSV
      • 演示→ 纯文本
      • 图纸→ PNG
    • 其他文件以其原生格式提供

入门

  1. 创建新的Google Cloud项目
  2. 启用Google Drive API
  3. 配置OAuth同意屏幕 (“内部”适合测试)
  4. 添加OAuth作用域 https://www.googleapis.com/auth/drive.readonly
  5. 创建OAuth客户端ID 适用于应用程序类型“桌面应用程序”
  6. 下载客户端OAuth密钥的JSON文件
  7. 将密钥文件重命名为 gcp-oauth.keys.json 并放入此repo的根目录中

确保使用以下任一方法构建服务器 npm run build 或 npm run watch.

认证

要验证和保存凭据,请执行以下操作:

  1. 使用运行服务器 auth 论点: node ./dist auth
  2. 这将在您的系统浏览器中打开身份验证流
  3. 完成身份验证过程
  4. 凭据将保存在此仓库的根目录中(即。 .gdrive-server-credentials.json)

使用桌面应用程序

要将此服务器与桌面应用程序集成,请将以下内容添加到应用程序的服务器配置中:

码头工人

身份验证:

假设您已经在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",
        "@mikegcoleman/google-drive-mcp"
      ],
      "env": {
        "GDRIVE_CREDENTIALS_PATH": "/path/to/.gdrive-server-credentials.json"
      }
    }
  }
}

使用VS代码

对于手动安装,请将以下JSON块添加到VS Code中的用户设置(JSON)文件中。您可以按 Ctrl + Shift + P 和打字 Preferences: Open User Settings (JSON).

您可以选择将其添加到名为的文件中 .vscode/mcp.json 在您的工作空间中。这将允许您与他人共享配置。

请注意 mcp 中不需要密钥 .vscode/mcp.json 文件。

NPX

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

码头工人

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

原创作品归属

该项目基于Google Drive MCP服务器 模型上下文协议服务器存档,最初由Anthropic、PBC开发,并根据MIT许可证获得许可。