Google Docs

🚀 最终 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：

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 智能助手集成，并执行各种复杂的文档操作。