🚀 最终 Google 文档终极指南

本项目是用于与 Google 文档交互的最小可行性项目（MCP），能让 Claude 智能助手通过命令对 Google 文档进行读取、写入和修改等操作，极大提升文档处理效率。

🚀 快速开始

克隆仓库

在终端运行如下命令克隆此仓库：

git clone https://github.com/your-username/google-docs-mcp.git

安装依赖项

进入项目目录并安装所有依赖项：

cd google-docs-mcp
npm install

✨ 主要特性

本项目允许 Claude 智能助手与 Google 文档交互，可执行读取、写入和修改等操作，还支持多种高级用法，如设置文本样式、段落样式、插入表格和旧版格式化等。

📦 安装指南

准备 credentials.json 文件

创建一个 credentials.json 文件，并添加以下内容，将 YOUR_PROJECT_ID 替换为你的 Google Cloud 项目 ID：

{
  "project_id": "YOUR_PROJECT_ID",
  "client_secret": "your_client_secret_here",
  "refresh_token": "your_refresh_token_here"
}

允许的 API

确保在 Google Cloud Console 中启用了以下 APIs：

1. 文档 AI API
2. 驱动器 API

添加测试用户

在 OAuth 一致性屏幕中，将你的电子邮件地址添加为测试用户。

💻 使用示例

基础用法

构建项目

运行以下命令构建项目：

npm run build

运行服务器

运行以下命令启动 MCP 服务器：

node dist/server.js

高级用法

• 文本样式：使用 applyTextStyle 方法将文本 "Important Section" 设置为粗体且红色 (#FF0000)。
• 段落样式：使用 applyParagraphStyle 将包含 "Title Here" 的段落居中对齐。
• 表格插入：在文档的索引 500 处插入一个 3x4 表格。
• 旧版格式化：使用 formatMatchingText 查找第二个出现的 "Project Alpha" 并将其设置为蓝色 (#0000FF)。

🔧 技术细节

安全与令牌存储

• .gitignore 文件：此仓库包含一个 .gitignore 文件，用于防止意外提交敏感文件 (credentials.json 和 token.json)。请勿删除这些条目。
• 令牌存储：此服务器将 Google 授权令牌存储在项目根目录中以简化设置。在生产环境中或更安全的环境中，请考虑使用系统密钥链、加密文件或其他机密管理服务来存储令牌。

故障排除

Claude 显示 "失败" 或 "无法附加"

• 检查 mcp_config.json 中的绝对路径是否正确。
• 确保已成功运行 npm run build 并且存在 dist 文件夹。
• 尝试在终端中手动运行命令：node /PATH/TO/YOUR/CLONED/REPO/mcp-googledocs-server/dist/server.js

Google 授权错误

• 确保启用了正确的 API（文档、驱动器）。
• 确保已将你的电子邮件地址添加为 OAuth 一致性屏幕中的测试用户。
• 验证 credentials.json 文件的内容是否正确。

📄 许可证

本项目受 MIT 许可证的保护。请查看 LICENSE 文件以获取详细信息。

通过遵循上述步骤，您可以轻松地将 Google 文档与 Claude 智能助手集成，并执行各种复杂的文档操作。