项目简介

MCP-GoogleDrive 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在将您在 Google Drive、Google Docs、Google Sheets 和 Google Slides 中的数据和功能无缝集成到各种支持 MCP 协议的 AI 助手中。它允许 AI 模型通过标准化的工具接口，智能地读取、搜索、编辑和管理您的 Google Workspace 文件。

主要功能点

文件管理与搜索: 获取特定类型（如文档、表格、幻灯片、PDF）的文件列表，或通过关键词搜索 Google Drive 中的文件。
文件内容阅览: 读取 Google 文档、Google 表格、Google 幻灯片和 PDF 文件的完整内容，或按文档标签、表格范围、幻灯片页码进行部分内容读取。
文件内容编辑:
- 在 Google 文档、Google 表格、Google 幻灯片中插入文本、数据或创建新元素。
- 在 Google 表格中创建各种图表（柱状图、折线图、饼图、条形图、散点图），或将数据可视化插入到文档和幻灯片中。
- 创建新的 Google 表格工作表或 Google 幻灯片。
- 复制 Google 表格中的工作表或 Google 幻灯片中的幻灯片。
- 合并 Google 表格中的指定单元格区域。
评论管理: 获取 Google 文档、Google 表格、Google 幻灯片中的所有评论，方便AI进行摘要或分析。
文件结构获取: 获取 Google 文档的标签列表和 Google 表格的工作表列表。

安装步骤

克隆仓库:

git clone https://github.com/Takatoshi-Miura/MCP-GoogleDrive.git
cd MCP-GoogleDrive/mcp-google-drive

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```
配置 Google API:
- 前往 Google Cloud Console 创建或选择项目。
- 启用以下 API: Google Drive API, Google Sheets API, Google Docs API, Google Slides API。
- 创建 OAuth 客户端 ID (选择桌面应用类型)。
- 下载 JSON 格式的客户端凭据文件，并将其命名为 'client_secret.json' 放置在 'MCP-GoogleDrive/mcp-google-drive/credentials/' 目录下。
运行自动认证:
```
npm run auto-auth
```
此命令将自动打开浏览器进行 Google 授权，并保存生成的 'token.json' 文件到 'credentials/' 目录。这是 MCP 服务器与 Google API 交互所必需的。

服务器配置

MCP 客户端（如 Claude Code 或 Cursor）需要知道如何启动此 MCP 服务器。您需要在客户端的 MCP 服务器配置中添加以下信息。

示例 (Cursor Settings - mcp.json 配置):

{
  "mcp-google-drive": {
    "command": "node",
    "args": [
      "[请替换为您的实际路径]/MCP-GoogleDrive/mcp-google-drive/build/index.js"
    ],
    "description": "允许AI助手访问和管理Google Drive文件、文档、表格和幻灯片。"
  }
}

'"mcp-google-drive"': 这是您为此 MCP 服务器指定的唯一名称。
'"command"': 启动服务器的可执行命令，这里是 'node'。
'"args"': 传递给 'command' 的参数列表。'[请替换为您的实际路径]/MCP-GoogleDrive/mcp-google-drive/build/index.js' 是服务器的入口文件路径，请务必将其替换为您的本地实际路径。
'"description"': 服务器功能的简要描述，有助于 AI 客户端理解其用途。

基本使用方法

配置完成后，当您在支持 MCP 的 AI 助手（如 Claude Code 或 Cursor）中提问时，AI 将能够识别并调用 MCP-GoogleDrive 服务器提供的工具。

例如，您可以这样与 AI 助手对话：

“列出我 Google Drive 中最近的 5 个 Google 表格文件。”
“搜索名为‘2023年销售报告’的 Google 文档，并总结其内容。”
“在 ID 为 '1Abc...xyz' 的 Google 表格的 Sheet1 中，将数据 '[['产品A', 100], ['产品B', 150]]' 追加到末尾。”
“在 ID 为 '1Def...uvw' 的 Google 幻灯片的第三页插入文本‘市场分析总结’，并将其放置在左上角。”
“在 Google 表格 '1Ghi...jkl' 中，使用 Sheet1 的 A1:B10 范围数据创建一个柱状图，标题为‘月度销售额’。”

AI 助手将根据您的指令，自动选择并调用 MCP-GoogleDrive 服务器中相应的工具，完成对 Google Workspace 文件的操作，并将结果返回给您。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息