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

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

版本：0\.2\.1
npm 元数据更新时间：2026-03-18T06:23:05.456Z
中文译文更新时间：2026-11-08T12:24:50.392Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：21.4 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-01-18T14:53:46.730Z
- 最新版本发布：2026-03-18T06:23:05.293Z
- 近 30 天下载量：4690（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

Google Drive 的 MCP 服务器 - 列表文件,从 Google Docs/ Sheets/ Slides 读取内容

## 安装

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

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

## README

# @ botrun/ mcp- google- 驱动程序

用于Google Drive集成的MCP(模式上下文协议)服务器. 列出文件,从Google Docs, Sheets,和幻灯片读取内容.

## 特征

-   📁 **列表驱动文件** - 在谷歌驱动器文件夹中列出所有文件
-   📄 **获取文件内容** - 从谷歌文档、工作表、幻灯片和其他文本文件中读取内容
-   🔓 **公众查阅** - 查阅无证书的公共档案
-   🔐 **私人访问** - 使用服务账户访问私人文件

## 安装

```bash
npm install -g @botrun/mcp-google-drive
```

或使用 npx:

```bash
npx @botrun/mcp-google-drive
```

## 在光标/ Claude 桌面中设置

添加到您的 MCP 配置文件 :

### 只针对公共文件( 不需要证书)

```json
{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["@botrun/mcp-google-drive"]
    }
  }
}
```

### 私人文件( 要求服务账户)

```json
{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["@botrun/mcp-google-drive"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json"
      }
    }
  }
}
```

## 获取服务账户证书

1.  转到 [谷歌云控台](https://console.cloud.google.com/)
2.  创建或选择一个工程
3.  启用 **谷歌驱动 API**
4.  转到 **全权证书** → **创建证书** → **服务账户**
5.  创建服务账户并下载 JSON 密钥文件
6.  与服务账户电子邮件共享您的 Google Drive 文件夹/ 文件

## 可用工具

### `list-drive-files`

在 Google Drive 文件夹中列出所有文件 .

**输入 :**

-   `url` (需要): Google Drive 文件夹 URL

**示例**

```
List files in https://drive.google.com/drive/folders/xxxxx
```

### `get-drive-file-content`

获取一个文件的内容 .

**输入 :**

-   `fileUrl` (需要): Google Drive 文件 URL 或文件 ID

**支持的格式 :**

-   Google Docs — 纯文本
-   谷歌工作表 – CSV
-   Google 幻灯片 — 纯文本
-   其他文本文件 — Raw 内容

**示例**

```
Read content from https://docs.google.com/document/d/xxxxx/edit
```

## 输出格式

所有答复都采用一致的JSON格式:

```json
{
  "isSuccess": true,
  "result": {
    "message": "Description"
    // ... data
  }
}
```

## 环境变量

| 变量 | 需求 | 说明 |
| --- | --- | --- |
| `GOOGLE_APPLICATION_CREDENTIALS` | 没有 | 服务账户 JSON 密钥文件路径 |

## 许可证

麻省理工学院

## 常见问题

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

Google Drive 的 MCP 服务器 - 列表文件,从 Google Docs/ Sheets/ Slides 读取内容

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

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

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

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

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

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

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

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

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

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

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

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