Google Drive MCP 服务器

Markdown 使用说明:

  • 项目简介
    • 这是一个基于 Model Context Protocol (MCP) 的后端服务器实现,目标是以标准化方式向 LLM 客户端提供上下文信息和功能,包括对 Google Drive 的资源托管与访问、工具注册与执行、以及提示模板的渲染与管理。
  • 主要功能点
    • 资源管理(可选启用)
      • 列出 Drive 中的文件和文件夹(资源列表)
      • 读取资源内容(文本、CSV、Markdown 等导出,非文本文件可下载)
      • 支持对 Shared Drives 的访问及文件导出
    • 工具集(必选/可选)
      • search:在 Drive 中全文检索文件
      • read:按文件 ID 读取并导出内容(文本型导出为 Markdown/CSV/Plain Text,二进制文件提供下载提示)
      • download:将文件下载到本地目录(文本/CSV/Markdown 等文本导出,二进制直接保存)
      • list_folder:列出文件夹内容
      • export_pdf:将文档等导出为 PDF 并保存本地
      • upload(可选):将本地文件上传到 Drive
      • sheets_read(可选):读取 Google Sheets,返回带表头的格式化表格
    • Prompts 支持:通过 MCP 服务器框架,支持对 Prompt 模板的获取和渲染(具体实现依赖于 MCP 客户端的使用)
  • 安装步骤
    • 安装所需 Node.js 环境
    • 克隆仓库、安装依赖、构建
    • 进行 Google OAuth 授权获取凭证文件(gcp-oauth.keys.json),并完成 API 授权以获得 access_token 与 refresh_token
    • 将凭证写入指定路径(默认 ~/.gdrive-server-credentials.json),以及 OAuth 客户端密钥(默认 ~/.gcp-oauth.keys.json)
  • 服务器配置 本 MCP 客户端配置示例(JSON,供客户端连接服务器时的参考注释;实际使用请根据环境替换路径与参数): { "serverName": "gdrive", "command": "node", "args": ["dist/index.js"], "env": { "GDRIVE_OAUTH_PATH": "/path/to/gcp-oauth.keys.json", "GDRIVE_CREDENTIALS_PATH": "/path/to/.gdrive-server-credentials.json" } // 注:此配置用于 MCP 客户端向服务器建立连接时的规范信息;实际的服务器进程启动命令及参数需由环境和部署方式决定。 }
  • 基本使用方法
    • 先完成授权获得 Google Drive 与 Sheets(如需要)访问权限
    • 启动 MCP 服务器(运行 dist/index.js,或通过 npm 构建产物)
    • 在 MCP 客户端中配置连接信息,指定服务器名称、启动命令及参数以建立连接(示例见上方配置)
    • 客户端可通过标准的 MCP 请求(如资源、工具、读取内容等)与服务器交互,获取统一格式的响应

服务器信息