Google Drive MCP Server

Google Drive MCP 服务

一个用于集成 Google Drive、基于 FastMCP 构建的模型上下文协议（MCP）服务。提供读取、写入、搜索和列出 Google Drive 文件的工具，重点支持 Google Docs 操作。

功能

• 文件操作：分页列出和搜索 Google Drive 中的文件
• 文档读取：读取 Google Docs 内容，支持分页和标签页选择
• 文档写入：写入 Google Docs，支持标签页选择和范围操作
• 身份验证：使用服务账号进行 Google Drive API 身份验证
• 分页：高效处理大型文档和文件列表

设置

1. 安装依赖项

uv sync

2. Google API 设置

1. 前往 Google Cloud 控制台
2. 创建新项目或选择现有项目
3. 启用 Google Drive API 和 Google Docs API
4. 创建服务账号并生成密钥
5. 下载服务账号密钥文件，并将其保存为项目根目录下的 service-account-key.json
6. 将要访问的 Google Drive 文件/文件夹共享给服务账号邮箱

3. 运行服务

python -m google_drive_mcp.server

无需身份验证流程——服务账号会使用密钥文件自动完成身份验证。

可用工具

list_files

列出 Google Drive 中的文件，支持可选的筛选和分页。

参数：

• folder_id（可选）：要列出文件的文件夹 ID（默认：根目录）
• page_size（可选）：每页文件数（默认：50，最大：100）
• page_token（可选）：用于分页的令牌
• mime_type（可选）：按 MIME 类型筛选（例如，'application/vnd.google-apps.document'）

search_files

使用查询语法搜索 Google Drive 中的文件。

参数：

• query：搜索查询（例如，'name contains "report"'）
• page_size（可选）：每页文件数（默认：50，最大：100）
• page_token（可选）：用于分页的令牌

read_document

分页读取 Google Docs 文档中的内容。

参数：

• document_id：Google Docs 文档 ID
• tab_id（可选）：要读取的特定标签页 ID
• start_index（可选）：起始字符索引（默认：0）
• length（可选）：要读取的字符数（默认：5000，最大：10000）

write_document

向 Google Docs 文档写入内容。

参数：

• document_id：Google Docs 文档 ID
• content：要写入的内容
• tab_id（可选）：要写入的特定标签页 ID
• insert_index（可选）：插入内容的位置索引（默认：末尾）
• replace_start（可选）：替换内容的起始索引
• replace_end（可选）：替换内容的结束索引

使用示例

搜索 Google Docs

# Search for documents containing "report"
search_files(query='name contains "report" and mimeType="application/vnd.google-apps.document"')

分页读取文档

# Read first 5000 characters
read_document(document_id="your_doc_id")

# Read next 5000 characters
read_document(document_id="your_doc_id", start_index=5000)

写入特定标签页

# Write to a specific tab in a document
write_document(
    document_id="your_doc_id",
    content="Hello, World!",
    tab_id="your_tab_id"
)

开发

项目结构

google_drive_mcp/
├── __init__.py
├── auth.py          # Google Drive authentication
└── server.py        # FastMCP server implementation

在开发环境中运行

# Install in development mode
uv pip install -e .

# Run the server
python -m google_drive_mcp.server

许可证

本项目采用 MIT 许可证。