关键词

Google Docs集成LLM工具文档自动化AI协作智能文档编辑

项目简介

'google-docs-mcp-server' 是一个非官方的 Model Context Protocol (MCP) 服务器实现，旨在为大型语言模型（如OpenAI、Claude）提供与Google Docs无缝交互的能力。通过此服务器，LLM 可以直接操作您的 Google 文档，执行创建、读取、更新、格式化、搜索、管理表格、插入媒体和调整文档结构等多种任务，极大地提升文档处理效率和智能化水平。

主要功能点

  • 文档创建与管理： 创建新的 Google 文档，并可指定初始内容、标题和基本格式。
  • 内容读取与搜索： 读取指定 Google 文档的完整内容，或通过关键词搜索 Google Drive 中的文档。
  • 文本编辑与替换： 在文档中插入、删除、替换特定位置或范围的文本，支持查找并替换功能。
  • 高级格式化： 应用字体、字号、字重（粗体）、字形（斜体）、下划线、删除线、颜色、对齐方式等多种文本和段落格式。
  • 列表与间距： 创建项目符号列表和编号列表，调整行间距和段落间距。
  • 表格操作： 插入表格，并支持表格的格式化（边框、颜色、表头）、单元格合并、增删行/列、调整列宽等复杂操作。
  • 媒体集成： 从 URL 插入图片，调整图片大小和对齐方式，并添加图片说明。甚至可以插入自定义形状的“绘图”。
  • 文档结构工具： 插入目录、分节符、书签、交叉引用、页眉、页脚和脚注，帮助构建复杂的文档结构。
  • 文档统计与辅助： 获取文档的字数、字符数、段落数等统计信息，并提供基本的拼写检查功能。
  • 身份验证： 通过 OAuth2 流程安全地连接 Google 账号，确保服务器对您的 Google Docs 和 Drive 拥有授权访问权限。

安装步骤

本服务器是为非编程用户设计的，您可以直接下载预编译的应用程序并运行：

  1. 检查系统要求：
    • 操作系统： Windows 10+、macOS 10.14+ 或 Linux。
    • 内存： 至少 4 GB RAM。
    • 存储： 至少 200 MB 可用磁盘空间。
    • 网络： 需连接互联网以访问 Google Docs。
  2. 下载应用程序： 访问 GitHub Releases 页面 (https://github.com/mattaspira/google-docs-mcp-server/releases)。
  3. 选择最新版本： 找到标记为 "Latest Release" 的最新版本。
  4. 下载对应版本： 根据您的操作系统点击相应的下载链接，将文件保存到您的电脑。

服务器配置（供MCP客户端使用）

MCP客户端需要配置服务器的启动命令才能连接。请参考以下JSON配置格式。 （注意：以下信息用于指导MCP客户端如何启动此服务器，请勿将以下内容直接视为代码。）

{
  "name": "Google Docs MCP Server",
  "description": "通过MCP协议连接LLM到Google Docs，实现文档的智能创建、编辑和管理。",
  "command": "node",
  "args": [
    "<path_to_your_downloaded_server_directory>/dist/src/index.js"
  ],
  "env": {
    "CREDENTIALS_PATH": "<path_to_your_downloaded_server_directory>/credentials.json",
    "TOKEN_PATH": "<path_to_your_downloaded_server_directory>/token.json"
  },
  "initialization_steps": [
    "在首次运行前，请确保您已在 '<path_to_your_downloaded_server_directory>' 目录中准备好 'credentials.json' 文件。",
    "首次启动服务器时，它将会在命令行中提示您打开一个URL以完成Google OAuth2身份验证。请在浏览器中完成授权。",
    "认证成功后，服务器会将 token 存储在 'token.json' 文件中，后续启动将自动使用该 token。"
  ],
  "capabilities": [
    "create_document", "create_formatted_document", "read_document", "search_documents",
    "append_text", "insert_text", "delete_text", "replace_text",
    "change_font", "change_font_size", "change_font_weight", "change_font_style",
    "apply_font_formatting", "format_text", "apply_heading", "set_alignment",
    "insert_table", "insert_page_break", "add_hyperlink", "create_bulleted_list",
    "create_numbered_list", "set_line_spacing", "set_paragraph_spacing",
    "transform_text_case", "apply_subscript", "apply_superscript",
    "format_table", "merge_table_cells", "insert_table_row", "insert_table_column",
    "delete_table_row", "delete_table_column", "set_table_column_width",
    "insert_image_from_url", "resize_image", "set_image_alignment", "add_image_caption", "insert_drawing",
    "insert_table_of_contents", "insert_section_break", "insert_bookmark", "add_cross_reference",
    "insert_header", "insert_footer", "insert_footnote",
    "find_and_replace", "search_text_in_document", "get_word_count", "spell_check",
    "check_auth_status"
  ]
}

说明：

  • 'name': 服务器名称，用于MCP客户端识别。
  • 'description': 服务器的功能描述。
  • 'command': 启动服务器的命令，通常是 'node'。
  • 'args': 传递给 'command' 的参数，这里是服务器主程序的路径。
    • '<path_to_your_downloaded_server_directory>'：请将其替换为您的服务器应用下载并解压后的根目录路径。例如，如果您解压到 '/Users/YourUser/google-docs-mcp-server-1.0.0'，则 'args' 中的路径应为 '"/Users/YourUser/google-docs-mcp-server-1.0.0/dist/src/index.js"'。
  • 'env': 环境变量，这里指定了 'credentials.json' 和 'token.json' 的路径。
    • '<path_to_your_downloaded_server_directory>'：请替换为 'credentials.json' 和 'token.json' 实际所在的目录。
  • 'initialization_steps': 重要的初始化提示，特别是关于 Google OAuth2 认证。
  • 'capabilities': 服务器注册的所有工具列表，MCP客户端可以根据此列表向用户展示可用的功能。

基本使用方法

  1. 运行应用程序： 双击下载的文件即可启动服务器。
  2. 完成Google授权： 首次运行会弹出浏览器窗口或在命令行提示一个URL，请按照指示登录您的Google账户并授权访问Google Docs和Drive。
  3. 服务器就绪： 授权完成后，服务器将自动保存凭证并进入运行状态。此时，您的MCP客户端（例如 LLM 应用）即可通过 MCP 协议与此服务器连接，并开始利用其提供的各项功能与 Google Docs 进行交互。您可以通过MCP客户端调用 'check_auth_status' 工具来验证认证状态。

信息

分类

生产力应用

访问项目