Google Drive server

基本能力

产品定位

mcp-gdrive-server 主要用于与 Google Drive 的集成，提供文件管理和搜索功能。

核心功能

• 文件搜索：通过 search 工具搜索 Google Drive 中的文件，返回文件名和 MIME 类型。
• 文件访问：支持通过 gdrive:///<file_id> 访问 Google Drive 中的文件，自动转换 Google Workspace 文件为通用格式。
• 多格式支持：支持所有文件类型，包括自动转换 Docs 为 Markdown、Sheets 为 CSV、Presentations 为纯文本、Drawings 为 PNG。

适用场景

• 需要从 Google Drive 中搜索和访问文件的应用。
• 需要将 Google Workspace 文件转换为通用格式的场景。
• 需要集成 Google Drive API 的开发者工具。

工具列表

• search：搜索 Google Drive 中的文件，输入为搜索查询字符串，返回匹配文件的文件名和 MIME 类型。

常见问题解答

1. 如何认证？

2. 运行 node ./dist auth 启动认证流程，完成后凭证会保存在 servers/.gdrive-server-credentials.json。

3. 如何与桌面应用集成？

4. 通过 Docker 或 NPX 配置服务器，具体配置见使用教程。

使用教程

使用依赖

1. 创建 Google Cloud 项目并启用 Google Drive API。
2. 配置 OAuth 同意屏幕并添加 https://www.googleapis.com/auth/drive.readonly 范围。
3. 创建桌面应用的 OAuth 客户端 ID 并下载 JSON 密钥文件。

安装教程

1. 将密钥文件重命名为 gcp-oauth.keys.json 并放置在项目根目录。
2. 使用 npm run build 或 npm run watch 构建服务器。

调试方式

1. 运行 node ./dist auth 进行认证。
2. 使用 Docker 或 NPX 启动服务器，具体命令如下：

Docker

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

NPX

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gdrive"
      ]
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款。