使用说明（Markdown 格式）

• 项目简介

  • 本项目实现一个面向 Google Docs 的 MCP 服务器端，能够以标准化的 MCP 模型上下文协议提供资源访问、工具执行与提示模板渲染等能力，方便与大模型/AI 助手进行对话式交互与自动化工作流集成。

• 主要功能点

  • 资源与工具暴露：提供对 Google Docs 的读取、写入、创建、搜索、分析、元数据获取等工具，供 MCP 客户端调用。
  • 全量分析能力：对文档内容进行统计、关键词提取、摘要生成、链接抽取、语言检测、结构分析等。
  • MCP 服务器模式：可将本服务以 MCP 服务器的方式对外暴露工具集合与能力声明，便于客户端动态发现可用工具。
  • 安全与鲁棒性：包含凭证管理、错误处理、速率限制与重试策略的实现，具备可扩展性与可维护性。

• 安装步骤

  • 确保已安装 Python 3.9+ 与依赖库（requirements.txt 中列出）。
  • 在本地环境或 Apify 平台上部署运行：
    • 本地运行示例：通过 apify run 启动 Actor。
    • 平台发布与部署：按 Apify 的标准流程进行推送与发布。

• 服务器配置（供 MCP 客户端参考，不需要转发给终端用户）

  • 服务器名称（serverName）：google-docs-mcp
  • 启动命令（command）：apify
  • 启动参数（args）：run
  • 说明：以上配置用于指明如何启动服务器端以接入 MCP 客户端，客户端将通过 MCP 的标准流程发现并调用暴露的工具与能力。

  服务器配置示例（以文本形式呈现，实际使用以客户端需求为准）： { "serverName": "google-docs-mcp", "command": "apify", "args": ["run"] }

• 基本使用方法

  • 启动服务器后，MCP 客户端可通过 JSON-RPC 风格的请求调用暴露的工具，例如读取文档、分析文档、创建文档等。
  • 客户端需要按服务器暴露的工具定义与参数规范组织请求参数，服务器返回统一的 JSON 结构，请求失败时提供错误信息以便排查。