Google Drive 服务器

这个MCP服务器与Google Drive集成，支持文件列表查询、读取和搜索功能。

组件

工具

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

资源

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

• 文件 (gdrive:///<file_id>)
  • 支持所有文件类型
  • Google Workspace文件会自动转换为以下格式：
    • 文档 → Markdown
    • 表格 → 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并放置到本仓库根目录（即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方式

认证：

假设你已经在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 Code集成

要快速安装，请使用下面的任一一键安装按钮：

对于手动安装，请将以下JSON块添加到VS Code的用户设置（JSON）文件中。你可以通过按Ctrl + Shift + P并输入Preferences: Open User Settings (JSON)来完成此操作。

或者，你可以将其添加到工作区中的.vscode/mcp.json文件中。这将允许你与他人共享配置。

注意：在.vscode/mcp.json文件中不需要mcp键。

NPX方式

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

Docker方式

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