JinDaGe - google-drive-server MCP Details

article

README

🚀 Google Drive 服务器

本 MCP 服务器与 Google Drive 集成，可实现文件的列出、读取与搜索功能，为您在 Google Drive 上的文件操作提供便利。

✨ 主要特性

工具

search
- 功能：在 Google Drive 中搜索文件。
- 输入：query（字符串），用于输入搜索查询内容。
- 输出：返回匹配文件的名称和 MIME 类型。

资源

该服务器支持对 Google Drive 文件的访问：

Files (gdrive:///<file_id>)
- 支持所有文件类型。
- 自动导出 Google Workspace 文件：
  - 文档 → Markdown
  - 表格 → CSV
  - 演示文稿 → 纯文本
  - 绘图 → PNG
- 其他文件以原生格式提供。

🚀 快速开始

环境准备

创建新的 Google Cloud 项目
启用 Google Drive API
配置 OAuth 同意屏幕（测试时“内部”即可）
添加 OAuth 作用域 https://www.googleapis.com/auth/drive.readonly
创建 OAuth 客户端 ID，选择应用类型“桌面应用”
下载客户端的 JSON 密钥文件
将密钥文件重命名为 gcp-oauth.keys.json 并放置在当前仓库根目录（例如 servers/gcp-oauth.keys.json）

服务器构建

确保使用 npm run build 或 npm run watch 建立服务器。

认证步骤

要认证并保存凭据，可按以下步骤操作：

使用 auth 参数运行服务器：node ./dist auth
浏览器会自动打开系统浏览器中的认证流程
完成认证过程
凭据将保存在当前仓库根目录（例如 servers/.gdrive-server-credentials.json）

与桌面应用集成

要在应用程序中使用此服务器，请将其配置到您的服务器设置：

Docker

认证：假设您已完成 Google Cloud 上的 OAuth 应用设置，现在可以使用以下命令对服务器进行认证，将 /path/to/gcp-oauth.keys.json 替换为您实际的密钥文件路径：

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，请在浏览器中打开并完成认证流程。凭据将保存到 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 文件。

google-drive-server