AI导哈

Google Drive文件管理服务

该服务提供与Google Drive集成的文件列表、读取和搜索功能，支持多种文件格式的自动转换和原生格式访问。

  • by scairnx
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 scairnx/mcp-gdrive

使用说明

谷歌云端硬盘服务器

此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"
      ],
      "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",
          "@modelcontextprotocol/server-gdrive"
        ],
        "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文件。

相关 MCP