🚀 最终 Google 文档终极指南
本项目是一个用于与 Google 文档交互的最小可行性项目（MCP）。借助它，Claude 智能助手能够通过命令执行读取、写入和修改 Google 文档内容等各类操作，为文档处理带来便利。
🚀 快速开始
克隆仓库
在终端中运行以下命令，将此仓库克隆到本地：
git clone https://github.com/your-username/google-docs-mcp.git
安装依赖项
进入项目目录，并安装项目所需的所有依赖项：
cd google-docs-mcp
npm install
🛠️ 设置
准备 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：
- 文档 AI API
- 驱动器 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 智能助手集成，并执行各种复杂的文档操作。