# @enterpret/google-drive-mcp 中文文档

规范地址：https://npmcn.com/package/%40enterpret/google-drive-mcp/

版本：0\.3\.4
npm 元数据更新时间：2026-10-27T08:27:20.724Z
中文译文更新时间：2026-11-14T03:11:27.899Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40enterpret/google-drive-mcp
原文对照：https://npmcn.com/package/%40enterpret/google-drive-mcp/?lang=original
项目主页：https://github.com/aavaz-ai/google-drive-mcp#readme
源码仓库：https://github.com/aavaz-ai/google-drive-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：355 kB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.13\.0
- 运行依赖：3 个
- 首次发布：2026-07-22T07:24:32.794Z
- 最新版本发布：2026-10-27T08:27:20.065Z
- 近 30 天下载量：2428（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

Enterpret管理 Google Drive MCP 用于驱动. file 授权内容,基于piotr-agier/google-drive-mcp

## 安装

```sh
npm install @enterpret/google-drive-mcp
```

也可以使用：`pnpm add @enterpret/google-drive-mcp`、`yarn add @enterpret/google-drive-mcp`、`bun add @enterpret/google-drive-mcp`

## README

# @ enterpret/ google- drive- mcp

Enterpret 的 Stdio- 仅限 Google Drive MCP 对于一个标记的应用授权内容 `Enterpret` 通过主机"Google Picker"流量直接授权的文件夹和资源. V1覆盖了My Drive,并在Google向活动用户曝光时直接与连接用户共享项目 `drive.file` 在 Picker 选择或应用程序创建后无记名。 共享驱动器产品支持不在验证和支持的V1范围外. 这包是受限的添加剂 [`piotr-agier/google-drive-mcp`](https://github.com/piotr-agier/google-drive-mcp) 并仅使用 OAuth 范围 `https://www.googleapis.com/auth/drive.file`。 。 。 .

来源和问题跟踪实况 [`aavaz-ai/google-drive-mcp`](https://github.com/aavaz-ai/google-drive-mcp)。原有的上游文档被单独保存,因此 npm 用户在本页面上可以看到更窄的 Enterpret 合同.

## 运行时间合同

主机必须运行Node.js 22.13.0 或稍后,并提供一个短寿命的访问符:

```bash
GOOGLE_DRIVE_OAUTH_BEARER='access-token' npx @enterpret/google-drive-mcp
```

可执行文件只接受 stdio 启动, `--help`,以及 `--version`。它不执行 Picker UI 本身、浏览器 OAuth 、 令牌刷新或持续、 HTTP/ 团队/ 服务账户模式、 多账户、 日历、 原始驱动查询、 二进制/ 本地/ 基础64 传输、 公共/ 域共享、 所有权转移或永久删除 .

服务器曝光了27个用于创建,授权和仅工作空间的发现,被绑定读取和更新,组织,可逆倒垃圾/还原,以及限制权限管理的工具. 每个呼叫者提供的物品或父ID都会通过 `files.get`;成功资源在内存中被归类为工作空间后代或直接授权资源. 外部文件夹为元数据并仅指定目标. Google Docs 的读取包含所有按文档顺序排列的标签和嵌入式标签,多标签的标签和被绑定的标签使用 `next_offset`。全内容替换只保留单调;多调更新被拒绝。 Google工作表读取并更新需要一个明确界限的A1单元格或长方形范围. 工作表读取了Google的零星行数组而未加编程,因此后行空行和单元格可能被省去,返回行长度可能有所不同;创建和更新值仍为矩形.

书信发送一次. 如果无法证明已发送的写入完整, 工具返回 `WRITE_UNKNOWN_OUTCOME`;呼叫者不得自动重放. 提供者机构、无记名值、文件内容和收件人不包含在错误或日志中.

## 读取文件内容

| 文件格式 | 阅读器 | 产出 |
| --- | --- | --- |
| 原生谷歌文档 | `read_google_doc` | 横跨标签和嵌入标签的文字 |
| 原生 Google 工作表 | `read_google_sheet` | 明确界限范围内的值 |
| 原生 Google 幻灯片 | `read_google_presentation` | 幻灯片文本 |
| TXT、马克下、CSV | `read_text_file` | UTF-8 文本 |
| PDF、DOCX、XLSX、PPTX、ODT、ODS、ODP、RTF | `read_text_file` | 已取出文本, 而非布局保存渲染 |

文件选择和 `canDownload` 阅读前需要许可。 列出文件不能证明文件内容是可读的 。 二进制文档有10个MiB下载限制,10万个字符取出-文本限制,并有限定的复杂度和解析时间. 使用 `next_offset` 以通过已提取的文本页面;每页重新检查授权。 较大的文件显然失败了,而不是默默地只返回它们的开始.

扫描/图像专用PDF、图像解释、音频/视频、档案、遗产 `.doc`编号 :`.xls`编号 :`.ppt`,则不支持密码保护文档。 图像,图表,公式的计算逻辑,和视觉布局不通过文本提取来复制. 没有执行OCR,远程转换服务,更广泛的OAuth范围,也没有执行文件转换写入. 原生工作表/滑行行为通过二进制文档支持而保持不变.

见 [国家](https://npmcn.com/package/%40enterpret/google-drive-mcp/ENTERPRET.md) 完整的管理合同 [读取](https://npmcn.com/package/%40enterpret/google-drive-mcp/README_UPSTREAM.md) 保存的上游文件。 第三方来源记录于 [第三次议会 NoTICES.md](https://npmcn.com/package/%40enterpret/google-drive-mcp/THIRD_PARTY_NOTICES.md)。 。 。 .

## 常见问题

### @enterpret/google-drive-mcp 是什么？

Enterpret管理 Google Drive MCP 用于驱动\. file 授权内容,基于piotr-agier/google-drive-mcp

### 如何安装 @enterpret/google-drive-mcp？

在项目目录运行 npm install @enterpret/google-drive-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 google-drive-mcp，可以用 npx google-drive-mcp 直接运行。

### @enterpret/google-drive-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/enterpret\_\_google-drive-mcp 是否存在。

### @enterpret/google-drive-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @enterpret/google-drive-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.13\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @enterpret/google-drive-mcp 可以商用吗？

@enterpret/google-drive-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @enterpret/google-drive-mcp 的下载量有多少？

根据 npm 官方下载统计，@enterpret/google-drive-mcp 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,428 次，日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @enterpret/google-drive-mcp 还在维护吗？

最新版本 0\.3\.4 发布于 2026/10/27（17 天前）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/07/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。