Google Docs

🚀 最終 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 智能助手集成，並執行各種複雜的文檔操作。