Google Drive MCP服务器

一种模型上下文协议（MCP）服务器，提供与Google Drive、文档、表格和幻灯片的安全集成。它允许Claude Desktop和其他MCP客户端通过标准化的界面管理Google Drive中的文件。

特性

多格式支持：使用谷歌文档、表格、幻灯片和常规文件
文件管理：创建、更新、删除、重命名和移动文件和文件夹
高级搜索：在整个Google云端硬盘中搜索
共享驱动器支持：除了My Drive之外，还可以完全访问Google共享驱动器（以前称为Team Drives）
文件夹导航：列出并浏览具有路径支持的文件夹层次结构（例如。， /Work/Projects)
MCP资源协议：可作为MCP资源访问的文件，用于读取内容
安全认证：OAuth 2.0，带有自动令牌刷新功能

示例用法

此MCP服务器通过自然语言实现强大的文件管理工作流：

1. 文档创建和组织

Create a new Google Doc called "Project Plan" in the folder /Work/Projects
with an outline for our Q1 initiatives including milestones and deliverables.

2. 文件搜索和组织

Search for files containing "budget" and organize them by moving each one
to the appropriate folder in your Drive hierarchy.

3. 电子表格创建

Create a Google Sheet called "Sales Analysis 2024" with columns for Date, Product,
Quantity, and Revenue to track your sales data.

4. 演示文稿创建

Create a presentation called "Product Roadmap" with slides outlining
our Q1 milestones, key features, and timeline.

5. 电子表格更新

Update the "Team Contacts" spreadsheet with new employee information
by modifying specific cells or ranges with the provided data.

6. 文档搜索

Search for documents in the /Reports folder and create a summary
document listing the files you found.

7. 文件夹和文档创建

Create a Templates folder and add standard documents like
a Meeting Notes template, Project Proposal template,
and Budget Spreadsheet template.

需求

Node.js：版本18或更高（建议使用LTS）
谷歌云项目：启用了以下API：

- Google Drive API - 谷歌文档API - 谷歌网页API - 谷歌幻灯片API

OAuth 2.0凭据：桌面应用程序类型（仅客户端ID-不需要客户端密码）

谷歌云设置

1.创建谷歌云项目

去谷歌云控制台
点击“选择项目”>“新建项目”
命名您的项目（例如，“Google Drive MCP”）
记下项目ID以备后用

2.启用所需的API

在您的项目中，转到“API和服务”>“库”
搜索并启用以下每个API：

- Google Drive API - 谷歌文档API - 谷歌网页API - 谷歌幻灯片API

等待每个API启用后再继续

3.配置OAuth同意屏幕

转到“API和服务”>“OAuth同意屏幕”
在“品牌”下填写必填字段：

- 应用程序名称：“我的个人Google Drive MCP” - 用户支持电子邮件：您的电子邮件 - 开发者联系人：您的电子邮件

在“观众”下：

- 为Google Workspace帐户选择“外部”（默认选择）或“内部” - 将您的电子邮件添加为测试用户

在“数据访问”下添加作用域。最佳用户体验的推荐范围如下：

- ./auth/drive.file - .../auth/documents - .../auth/spreadsheets - .../auth/presentations - .../auth/drive - .../auth/drive.readonly

4.创建OAuth 2.0凭据

转到“API和服务”>“凭据”
点击“+创建证书”>“OAuth客户端ID”
应用程序类型： 桌面应用 （重要！）
名称：“谷歌云端硬盘MCP客户端”
点击“创建”
下载JSON文件
将其重命名为 gcp-oauth.keys.json

安装

选项1：与npx一起使用（推荐）

您可以直接运行服务器，无需安装：

# Run the server (authentication happens automatically on first run)
npx aegaea-drive-mcp

# Optional: Run authentication manually if needed
npx aegaea-drive-mcp auth

选项2：本地安装

克隆并安装：

   git clone https://github.com/camerhann/aegaea-drive-mcp-fixed.git
   cd google-drive-mcp
   npm install

设置凭据：

   # Copy the example file
   cp gcp-oauth.keys.example.json gcp-oauth.keys.json

   # Edit gcp-oauth.keys.json with your OAuth client ID

身份验证（可选）：

   npm run auth

注意：如果跳过此步骤，则MCP客户端首次运行时会自动进行身份验证。

Docker 使用

先决条件

首先在本地进行身份验证 -Docker容器无法打开OAuth浏览器：

   # Using npx
   npx aegaea-drive-mcp auth

   # Or using local installation
   npm run auth

验证令牌位置:

   ls -la ~/.config/google-drive-mcp/tokens.json

构建Docker镜像

构建项目 （Docker构建前需要）：

   npm install
   npm run build

构建Docker镜像:

   docker build -t google-drive-mcp .

运行Docker容器

运行装载了凭据和令牌的容器：

docker run -it \
  -v /path/to/gcp-oauth.keys.json:/config/gcp-oauth.keys.json:ro \
  -v ~/.config/google-drive-mcp/tokens.json:/config/tokens.json \
  google-drive-mcp

重要提示：

替换 /path/to/gcp-oauth.keys.json 使用OAuth凭据的实际路径
这 :ro 出于安全考虑，标志将凭据挂载为只读
令牌以读写方式挂载，以允许自动刷新
为了安全起见，容器以非root用户身份运行

Claude桌面版的Docker配置

添加此配置以在Claude Desktop中使用Docker容器：

{
  "mcpServers": {
    "google-drive": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/path/to/gcp-oauth.keys.json:/config/gcp-oauth.keys.json:ro",
        "-v",
        "/Users/yourname/.config/google-drive-mcp/tokens.json:/config/tokens.json",
        "google-drive-mcp"
      ]
    }
  }
}

Docker特定注意事项：

用途 -i 用于交互模式（MCP stdio通信所需）
用途 --rm 退出后自动移除容器
无需端口映射（MCP使用stdio，而不是HTTP）
环境变量在Dockerfile中设置

配置

OAuth凭据配置

服务器支持多种提供OAuth凭据的方法（按优先级顺序）：

1. 环境变量（推荐）

export GOOGLE_DRIVE_OAUTH_CREDENTIALS="/path/to/your/gcp-oauth.keys.json"

2. 默认文件位置

地方 gcp-oauth.keys.json 在项目根目录中

令牌存储

身份验证令牌按照XDG基本目录规范安全存储：

优先级	位置	配置
1	自定义路径	设置 `GOOGLE_DRIVE_MCP_TOKEN_PATH` 环境变量
2	XDG配置	`$XDG_CONFIG_HOME/google-drive-mcp/tokens.json`
3	默认值	`~/.config/google-drive-mcp/tokens.json`

安全说明：

令牌是使用安全权限创建的（0600）
从不将令牌提交到版本控制
令牌在到期前自动刷新
处于“测试”状态的Google OAuth应用程序具有7天后过期的刷新令牌（Google的政策）

使用克劳德代码（CLI）

使用添加服务器 claude mcp add 命令：

# Add with user scope (available across all projects)
claude mcp add google-drive -t stdio -s user \
  -e "GOOGLE_DRIVE_OAUTH_CREDENTIALS=/path/to/your/gcp-oauth.keys.json" \
  -e "GOOGLE_DRIVE_MCP_TOKEN_PATH=/path/to/your/tokens.json" \
  -- npx -y aegaea-drive-mcp

范围选项：

user -可用于所有项目（存储在 ~/.claude.json)
local -仅在当前项目中可用（默认）
project -通过与团队共享 .mcp.json 在项目根中

验证服务器是否已连接

# List all MCP servers and their status
claude mcp list

您应该看到： google-drive: npx -y aegaea-drive-mcp - ✓ Connected

重要说明

需要重新启动：添加后， 完全重新启动Claude Code （退出并重新打开）工具可用
MCP服务器在启动时连接，在会话期间不进行热重新加载
这 -y npx命令中的标志自动确认软件包安装

飞行前检查

在使用Claude Code之前，请验证您的凭据配置是否正确：

npx aegaea-drive-mcp status

这将检查您的OAuth凭据、令牌和API连接。

使用Claude Desktop

将服务器添加到您的Claude Desktop配置中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

使用npx（推荐）：

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "aegaea-drive-mcp"],
      "env": {
        "GOOGLE_DRIVE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }
  }
}

使用本地安装：

{
  "mcpServers": {
    "google-drive": {
      "command": "node",
      "args": ["/absolute/path/to/aegaea-drive-mcp/dist/index.js"],
      "env": {
        "GOOGLE_DRIVE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }
  }
}

备注：替换 /path/to/your/gcp-oauth.keys.json 使用OAuth凭据文件的实际路径。

可用工具

搜索与导航

搜索 -在Google云端硬盘上搜索文件

- query：搜索词 - pageSize：每页结果数（可选，默认50，最大100） - pageToken：下一页的分页标记（可选）

list文件夹 -列出文件夹的内容

- folderId：文件夹ID（可选，默认为root） - pageSize：结果数量（可选，最多100个） - pageToken：分页标记（可选）

文件管理

createTextFile -创建文本或markdown文件

- name：文件名（必须以.txt或.md结尾） - content：文件内容 - parentFolderId：父文件夹ID（可选）

更新文本文件 -更新现有文本文件

- fileId：要更新的文件ID - content：新内容 - name：新名称（可选）

删除项目 -将文件或文件夹移动到垃圾箱（不是永久删除-项目可以从Google Drive垃圾箱中恢复）

- itemId：要移至回收站的物品ID

重命名项目 -重命名文件或文件夹

- itemId：要重命名的项目ID - newName：新名称

moveItem -移动文件或文件夹

- itemId：要移动的项目ID - destinationFolderId：目标文件夹ID

文件夹操作

创建文件夹 -创建新文件夹

- name：文件夹名称 - parent：父文件夹ID或路径（可选）

Google 工作区

创建GoogleDoc -创建Google文档

- name：文档名称 - content：文档内容 - parentFolderId：父文件夹ID（可选）

Updategooglio -更新Google文档

- documentId：文档ID - content：新内容

getGoogleDocContent -使用文本索引获取文档内容

- documentId：文档ID - 返回带有字符位置的文本以进行格式化

格式GoogleDocText -将文本格式应用于某个范围

- documentId：文档ID - startIndex：起始位置（从1开始） - endIndex：结束位置（从1开始） - bold：将文本加粗（可选） - italic：将文本设置为斜体（可选） - underline：文本下划线（可选） - strikethrough：划线文本（可选） - fontSize：字体大小（可选） - foregroundColor：文本颜色为RGB（0-1）（可选）

格式谷歌文档段落 -将段落格式应用于某个范围

- documentId：文档ID - startIndex：起始位置（从1开始） - endIndex：结束位置（从1开始） - namedStyleType：样式如HEADING_1、HEADING_2等。（可选） - alignment：开始、居中、结束或正时（可选） - lineSpacing：行距乘数（可选） - spaceAbove：段落上方空格（可选） - spaceBelow：段落下方空格（可选）

创建Google表 -创建谷歌表格

- name：电子表格名称 - data：二维单元格值数组 - parentFolderId：父文件夹ID（可选）

下载中 -更新谷歌表格

- spreadsheetId：电子表格ID - range：要更新的范围（例如，“A1:C10”） - data：新值的二维数组

创建GoogleSlides -创建演示文稿

- name：演示文稿名称 - slides：带有标题和内容的幻灯片数组 - parentFolderId：父文件夹ID（可选）

更新 -更新现有演示文稿

- presentationId：演示文稿ID - slides：带有标题和内容的幻灯片数组（替换所有现有幻灯片）

谷歌表格格式化工具

getGoogleSheetContent -获取包含单元格信息的电子表格内容

- spreadsheetId：电子表格ID - range：要获取的范围（例如，“Sheet1！A1:C10”） - 返回指定范围的单元格值

格式谷歌表格单元格 -设置单元格属性格式

- spreadsheetId：电子表格ID - range：范围到格式（例如，“A1:C10”） - backgroundColor：单元格背景颜色（RGB 0-1）（可选） - horizontalAlignment：左、中或右（可选） - verticalAlignment：顶部、中部或底部（可选） - wrapStrategy：OVERFLOW_CELL、CLIP或WRAP（可选）

格式googlesheettext -将文本格式应用于单元格

- spreadsheetId：电子表格ID - range：范围到格式（例如，“A1:C10”） - bold：将文本加粗（可选） - italic：将文本设置为斜体（可选） - strikethrough：划线文本（可选） - underline：文本下划线（可选） - fontSize：字体大小（可选） - fontFamily：字体名称（可选） - foregroundColor：文本颜色（RGB 0-1）（可选）

格式谷歌表格编号 -应用数字/日期格式

- spreadsheetId：电子表格ID - range：范围到格式（例如，“A1:C10”） - pattern：格式模式（例如，“#，###0.00”，“yyyy-mm-dd”，“$#，###.00”，“0.00%”） - type：数字、货币、百分比、日期、时间、日期时间或科学（可选）

设置 -配置单元格边框

- spreadsheetId：电子表格ID - range：范围到格式（例如，“A1:C10”） - style：实心、抹面、点状或双面 - width：边框厚度1-3（可选） - color：边框颜色（RGB 0-1）（可选） - top, bottom, left, right：适用于特定边界（可选） - innerHorizontal, innerVertical：应用于内边框（可选）

合并GoogleSheetCells -合并某个范围内的单元格

- spreadsheetId：电子表格ID - range：要合并的范围（例如“A1:C3”） - mergeType：MERGE_ALL、MERGE_COLUMNS或MERGE_ROWS

addGoogleSheet条件格式 -添加条件格式规则

- spreadsheetId：电子表格ID - range：应用格式的范围（例如“A1:C10”） - condition：条件配置 - type：NUMBER_GREATER、NUMBER_LESS、TEXT_CONTAINS、TEXT_ARTS_WITH、TEXT_ENDS_WITH或CUSTOM_FORMULA - value：要比较的值或公式 - format：条件为真时应用的格式 - backgroundColor：单元格颜色（RGB 0-1）（可选） - textFormat：带粗体和前景颜色的文本格式（可选）

谷歌幻灯片格式化工具

获取谷歌幻灯片内容 -获取包含元素ID的演示内容

- presentationId：演示文稿ID - slideIndex：特定幻灯片索引（可选） - 返回用于格式化的元素ID

格式化谷歌搜索文本 -将文本格式应用于幻灯片元素

- presentationId：演示文稿ID - objectId：元素ID - startIndex/endIndex：文本范围（可选） - bold, italic, underline, strikethrough：文本样式 - fontSize：字体大小（以点为单位） - fontFamily：字体名称 - foregroundColor：文本颜色（RGB 0-1）

格式谷歌幻灯片段落 -应用段落格式

- presentationId：演示文稿ID - objectId：元素ID - alignment：开始、中心、结束或正当 - lineSpacing：行距乘数 - bulletStyle：无、圆盘、箭头、方形、钻石、星星或数字

styleGoogleSlidesShape -样式形状和元素

- presentationId：演示文稿ID - objectId：形状ID - backgroundColor：填充颜色（RGBA 0-1） - outlineColor：边框颜色（RGB 0-1） - outlineWeight：边界厚度（以点为单位） - outlineDashStyle：实心、DOT、DASH等。

设置 -设置幻灯片背景颜色

- presentationId：演示文稿ID - pageObjectIds：幻灯片ID数组 - backgroundColor：背景颜色（RGBA 0-1）

创建GoogleSlidesTextBox -创建格式化文本框

- presentationId：演示文稿ID - pageObjectId：幻灯片ID - text：文本内容 - x, y, width, height：动车组中的位置/尺寸（1/360000厘米） - fontSize, bold, italic：文本格式（可选）

创建GoogleSlidesShape -创建样式化形状

- presentationId：演示文稿ID - pageObjectId：幻灯片ID - shapeType：矩形、椭圆形、钻石、三角形、星形、圆形或箭头 - x, y, width, height：EMU中的位置/尺寸 - backgroundColor：填充颜色（RGBA 0-1）（可选）

身份验证流程

服务器使用OAuth 2.0进行安全身份验证：

自动身份验证（首次运行）

服务器检测到缺少令牌并启动本地身份验证服务器
您的浏览器将打开谷歌的同意页面
授予请求的权限
代币被安全地保存到 ~/.config/google-drive-mcp/tokens.json
服务器继续启动

许可证管理

自动刷新：令牌在到期前自动刷新
安全存储：以0600权限存储的令牌
迁移：传统令牌会自动迁移到安全位置

手动重新身份验证

需要时运行auth命令：

切换Google帐户
刷新过期令牌（对于处于“测试”状态的应用程序，Google会在7天后过期刷新令牌）
从已撤销的访问中恢复

# Using npx
npx aegaea-drive-mcp auth

# Using local installation
npm run auth

安全

安全功能

无客户机密：桌面OAuth流仅适用于客户端ID
安全令牌存储：在XDG兼容位置以0600权限存储的令牌
范围访问：请求的最小权限（drive.file、文档、电子表格、演示文稿）
本地执行：所有处理都在您的机器上进行
自动令牌刷新：减少重新身份验证的需要
令牌迁移：传统令牌自动移动到安全位置

最佳实践

从不提交凭据：添加到 .gitignore:

   gcp-oauth.keys.json
   client_secret*.json
   .config/

使用环境变量 用于生产：

   export GOOGLE_DRIVE_OAUTH_CREDENTIALS="/secure/path/credentials.json"
   export GOOGLE_DRIVE_MCP_TOKEN_PATH="/secure/path/tokens.json"

监控访问:

- 查看Google Drive中最近的活动 - 定期检查OAuth应用程序权限

撤销OAuth访问

如果您需要撤销Google Drive MCP对您的Google帐户的访问权限：

访问 Google帐户权限
在列表中找到“Google Drive MCP”或您的自定义应用程序名称
点击它并选择“删除访问权限”
清除本地令牌以完成吊销：

   rm ~/.config/google-drive-mcp/tokens.json

撤销访问权限后，您需要在下次使用服务器时重新进行身份验证。

故障排除

常见问题及解决方法

“找不到OAuth凭据”

OAuth credentials not found. Please provide credentials using one of these methods:
1. Environment variable:
   export GOOGLE_DRIVE_OAUTH_CREDENTIALS="/path/to/gcp-oauth.keys.json"
2. Default file path:
   Place your gcp-oauth.keys.json file in the package root directory.

解决方案：

从谷歌云控制台下载凭据
设置环境变量或将文件放置在项目根目录中
确保文件具有适当的读取权限

“身份验证失败”或浏览器未打开

可能的原因：

凭证类型错误：必须是“桌面应用程序”，而不是“Web应用程序”
端口被阻塞：端口3000-3004必须可用
未添加测试用户：在OAuth同意屏幕中添加您的电子邮件

解决方案：

# Check if ports are in use
lsof -i :3000-3004

# Kill processes if needed
kill -9 

# Re-run authentication
npx aegaea-drive-mcp auth

“令牌过期”或“授予无效”

对于处于“测试”状态的Google OAuth应用程序：

谷歌在7天后自动过期刷新令牌
在发布应用程序之前，您需要每周重新进行身份验证

解决方案：

# Clear old tokens and re-authenticate
rm ~/.config/google-drive-mcp/tokens.json
npx aegaea-drive-mcp auth

生产：

在Google Cloud Console中将应用程序移动到“已发布”状态
完成OAuth验证过程

即使使用有效令牌，也会出现“需要登录”错误

如果您更新了OAuth作用域，但仍然收到错误：

即使在删除本地令牌后，谷歌也会缓存应用程序授权
应用程序可能正在使用旧的/有限的作用域

解决方案：

首选 Google帐户权限
查找并删除“Google Drive MCP”的访问权限
清除本地令牌： rm ~/.config/google-drive-mcp/tokens.json
重新验证以授予所有必需的作用域
验证同意屏幕是否显示所有范围，包括完全驱动器访问权限

“API未启用”错误

Error: Google Sheets API has not been used in project...

解决方案：

首选谷歌云控制台
选择您的项目
导航到“API和服务”>“库”
搜索并启用丢失的API
等待1-2分钟进行传播

“权限不足”

检查凭据中的范围：

需要drive.file或驱动器范围
需要相应服务的文档、表格、幻灯片范围

解决方案：

使用正确的作用域重新创建OAuth凭据
更新凭据后重新进行身份验证

速率限制（429个错误）

Google API配额：

驱动API：每分钟12000个请求
文件/表格/幻灯片：每分钟300个请求

解决方案：

实施指数回退
在可能的情况下进行批量操作
在Google Cloud Console中检查配额使用情况

Docker特定问题

Docker中的“需要身份验证”

问题： 即使您有有效的令牌，Docker中的MCP服务器也会显示身份验证错误。

原因： OAuth流需要浏览器访问，这在Docker容器中不可用。

解决方案：

# 1. Authenticate outside Docker first
npx aegaea-drive-mcp auth

# 2. Verify tokens exist
ls -la ~/.config/google-drive-mcp/tokens.json

# 3. Run Docker with tokens mounted
docker run -it \
  -v $(pwd)/gcp-oauth.keys.json:/config/gcp-oauth.keys.json:ro \
  -v ~/.config/google-drive-mcp/tokens.json:/config/tokens.json \
  google-drive-mcp

Docker构建期间“npm ci失败”

问题： Docker构建失败 tsc: not found 或类似的错误。

解决方案：

# Build the project locally first
npm install
npm run build

# Then build Docker image
docker build -t google-drive-mcp .

Dockerfile期望 dist/ 本地版本中存在的目录。

Docker中“令牌刷新失败”

问题： 令牌无法在容器内刷新。

解决方案： 确保令牌文件以写权限装载：

# Correct: tokens can be updated
-v ~/.config/google-drive-mcp/tokens.json:/config/tokens.json

# Wrong: read-only mount prevents token refresh
-v ~/.config/google-drive-mcp/tokens.json:/config/tokens.json:ro

调试模式

启用详细日志记录：

# Set debug environment variable
export DEBUG=google-drive-mcp:*
npx aegaea-drive-mcp

获取帮助

检查日志：服务器将错误记录到stderr
验证设置：运行 npx aegaea-drive-mcp help
测试认证：运行 npx aegaea-drive-mcp auth
报告问题:

发展

项目结构

google-drive-mcp/
├── src/                    # Source code
│   ├── index.ts           # Main server implementation
│   ├── auth.ts            # Main authentication module
│   └── auth/              # Authentication components
│       ├── client.ts      # OAuth2 client setup
│       ├── server.ts      # Local auth server
│       ├── tokenManager.ts # Token storage and validation
│       └── utils.ts       # Auth utilities
├── dist/                  # Compiled JavaScript (generated)
├── scripts/               # Build scripts
│   └── build.js          # Custom build script
├── gcp-oauth.keys.json    # OAuth credentials (create from example)
├── gcp-oauth.keys.example.json # Example credentials file
├── package.json           # NPM package configuration
├── tsconfig.json          # TypeScript configuration
├── LICENSE                # MIT license
└── README.md             # This file

建筑

npm run build    # Compile TypeScript
npm run watch    # Compile and watch for changes
npm run typecheck # Type checking without compilation

脚本

npm start -启动已编译的服务器
npm run auth -运行身份验证流
npm run build -构建项目（运行类型检查+自定义构建脚本）
npm run watch -构建并观察变化
npm run typecheck -仅运行TypeScript类型检查
npm run lint -运行TypeScript类型检查（类型检查的别名）
npm run prepare -在npm发布之前自动运行build
npm test -运行测试（占位符-尚未实现测试）

高级配置

环境变量

用户配置变量

凭证（必填-使用以下方法之一）：

变量	描述	示例
`GOOGLE_DRIVE_OAUTH_CREDENTIALS`	OAuth凭据JSON文件的路径	`/home/user/secrets/oauth.json`
（或将文件放在）	默认位置： `gcp-oauth.keys.json` 在项目根中	`./gcp-oauth.keys.json`

可选的 （用于定制）：

变量	描述	默认值	示例
`GOOGLE_DRIVE_MCP_TOKEN_PATH`	覆盖令牌存储位置	`~/.config/google-drive-mcp/tokens.json`	`/custom/path/tokens.json`
`DEBUG`	启用调试日志记录	（已禁用）	`google-drive-mcp:*`

系统变量（如果存在，则由代码库使用）

这些是应用程序读取的标准系统环境变量，但通常不需要设置：

变量	描述	用于
`XDG_CONFIG_HOME`	Linux/Unix配置目录标准	确定默认令牌存储位置
`NODE_ENV`	Node.js环境模式	可能影响错误处理和日志记录

弃用的变量（不要使用）

变量	描述
`GOOGLE_TOKEN_PATH`	旧令牌路径-使用 `GOOGLE_DRIVE_MCP_TOKEN_PATH` 相反
`GOOGLE_CLIENT_SECRET_PATH`	旧凭据路径-使用 `GOOGLE_DRIVE_OAUTH_CREDENTIALS` 相反

许可证

MIT-有关详细信息，请参阅许可证文件

贡献

欢迎投稿！拜托：

分叉存储库
创建要素分支(git checkout -b feature/amazing-feature)
提交您的更改(git commit -m 'Add amazing feature')
推到分支(git push origin feature/amazing-feature)
打开拉取请求

支持

📚 文档
🐛 问题追踪器

致谢

建于模型上下文协议
用途
受到MCP社区的启发

Aegaea Drive MCP Fixed

快速接入

详细介绍

Google Drive MCP服务器

特性

示例用法

1. 文档创建和组织

2. 文件搜索和组织

3. 电子表格创建

4. 演示文稿创建

5. 电子表格更新

6. 文档搜索

7. 文件夹和文档创建

需求

谷歌云设置

1.创建谷歌云项目

2.启用所需的API

3.配置OAuth同意屏幕

4.创建OAuth 2.0凭据

安装

选项1：与npx一起使用（推荐）

选项2：本地安装

Docker 使用

先决条件

构建Docker镜像

运行Docker容器

Claude桌面版的Docker配置

配置

OAuth凭据配置

1. 环境变量 （推荐）

2. 默认文件位置

令牌存储

使用克劳德代码（CLI）

验证服务器是否已连接

重要说明

飞行前检查

使用Claude Desktop

使用npx（推荐）：

使用本地安装：

可用工具

搜索与导航

文件管理

文件夹操作

Google 工作区

谷歌表格格式化工具

谷歌幻灯片格式化工具

身份验证流程

自动身份验证（首次运行）

许可证管理

手动重新身份验证

安全

安全功能

最佳实践

撤销OAuth访问

故障排除

常见问题及解决方法

“找不到OAuth凭据”

“身份验证失败”或浏览器未打开

“令牌过期”或“授予无效”

即使使用有效令牌，也会出现“需要登录”错误

“API未启用”错误

“权限不足”

速率限制（429个错误）

Docker特定问题

Docker中的“需要身份验证”

Docker构建期间“npm ci失败”

Docker中“令牌刷新失败”

调试模式

获取帮助

发展

项目结构

建筑

脚本

高级配置

环境变量

用户配置变量

系统变量（如果存在，则由代码库使用）

弃用的变量（不要使用）

许可证

贡献

1. 环境变量（推荐）