Google Docs MCP Server

Google Docs MCP Server

site icon
2025.04.22 0
JavaScript文档管理自动化处理团队协作内容生成交流协作
Google Docs MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现,用于无缝集成 Google Docs API,使 AI 助手能够创建、读取、更新和管理 Google 文档。该服务提供了丰富的功能,包括文档的创建、检索、更新、删除、导出、分享和搜索等,适用于需要自动化处理 Google 文档的各种场景。
View on GitHub

Overview

基本能力

产品定位

Google Docs MCP Server 是一个用于自动化处理 Google 文档的服务,通过与 Google Docs API 的集成,提供文档的创建、管理、分享和搜索等功能。

核心功能

  • 创建新的 Google 文档,支持自定义标题和内容
  • 检索文档内容和元数据
  • 更新现有文档内容
  • 列出所有可访问的文档
  • 删除文档
  • 将文档导出为不同格式(PDF、纯文本等)
  • 与特定用户共享文档
  • 按标题或内容搜索文档
  • 验证连接和凭据

适用场景

  • 自动化文档生成和管理
  • 团队协作中的文档共享和更新
  • 文档内容的批量处理和导出
  • 文档搜索和分类

工具列表

工具名称 描述 必需参数
google_docs_create 创建新的 Google 文档 title, content(可选)
google_docs_get 通过 ID 获取 Google 文档 documentId
google_docs_update 更新 Google 文档内容 documentId, content, replaceAll(可选)
google_docs_list 列出认证用户可访问的 Google 文档 pageSize(可选), pageToken(可选)
google_docs_delete 删除 Google 文档 documentId
google_docs_export 将 Google 文档导出为不同格式 documentId, mimeType(可选)
google_docs_share 与特定用户共享 Google 文档 documentId, emailAddress, role(可选)
google_docs_search 按标题或内容搜索 Google 文档 query, pageSize(可选), pageToken(可选)
google_docs_verify_connection 验证与 Google Docs API 的连接

常见问题解答

  1. 如何设置认证凭据?
  2. 可以通过服务账户、API 密钥或 OAuth2 进行认证。具体设置步骤见安装教程。
  3. 如何获取刷新令牌?
  4. 使用提供的 get-refresh-token.js 脚本获取 OAuth2 刷新令牌。
  5. 如何运行 SSE 服务器?
  6. 使用 npx mcp-proxy-auth node dist/index.js 命令运行 SSE 服务器。

使用教程

使用依赖

  • Node.js 18 或更高版本
  • 启用了 Google Docs API 的 Google Cloud 项目
  • 认证凭据(API 密钥、服务账户或 OAuth2)

安装教程

  1. 克隆仓库: bash git clone https://github.com/lkm1developer/google-docs-mcp-server.git cd google-docs-mcp-server
  2. 安装依赖: bash npm install
  3. 创建 .env 文件并配置 Google Cloud 凭据。

调试方式

  1. 构建项目: bash npm run build
  2. 测试连接: bash npx tsx src/test-connection.ts
  3. 运行服务器: bash npm start
  4. 运行 SSE 服务器: bash npx mcp-proxy-auth node dist/index.js

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。