Google Docs MCP Server

Google Docs MCP Server

site icon
2025.04.17 0
JavaScript文档管理API集成自动化工具内容生成交流协作
Google Docs MCP Server 是一个强大的模型上下文协议(MCP)服务器实现,用于无缝集成Google Docs API,使AI助手能够创建、读取、更新和管理Google文档。
View on GitHub

Overview

基本能力

产品定位

Google Docs MCP Server 是一个专门为AI助手设计的中间件,用于与Google Docs API进行交互,实现文档的自动化管理。

核心功能

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

适用场景

  • AI助手自动化文档创建和管理
  • 团队协作中的文档自动化处理
  • 内容生成和批量文档处理
  • 文档备份和导出

工具列表

工具名称 描述 必需参数
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. 认证问题:确保已正确设置Google Cloud项目并启用Google Docs API和Google Drive API
  2. 权限问题:服务账户需要具有"Docs API User"和"Drive API User"角色
  3. 环境变量:确保.env文件中包含所有必需的认证信息

使用教程

使用依赖

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

安装教程

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

调试方式

  1. 测试连接:
npx tsx src/test-connection.ts
  1. 运行服务器:
npm start
  1. 运行SSE服务器:
npx mcp-proxy-auth node dist/index.js
  1. 使用Docker运行:
docker build -t google-docs-mcp-server .
docker run -p 8080:8080 -e GOOGLE_CLOUD_PROJECT_ID=your-project-id ...

许可证

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