Google Drive文件管理服务

该服务集成Google Drive API,提供文件搜索、读取及格式转换功能,适用于需要自动化管理云端文件的场景。

  • by tonioshikanlu
  • JavaScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 tonioshikanlu/mcp-gdrive-server

使用说明

谷歌云端硬盘服务器

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

组件

工具

  • 搜索
    • 在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的根目录中(即。 servers/gcp-oauth.keys.json)

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

认证

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

  1. 使用运行服务器 auth 论点: node ./dist auth
  2. 这将在您的系统浏览器中打开身份验证流
  3. 完成身份验证过程
  4. 凭据将保存在此仓库的根目录中(即。 servers/.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",
        "@modelcontextprotocol/server-gdrive"
      ]
    }
  }
}

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息,请参阅项目存储库中的LICENSE文件。