Google Docs MCP Server

🚀 Google Docs MCP 服務器

Google Docs MCP 服務器是一箇中間件平臺，用於與 Google 文檔 API 進行交互。它支持通過命令對 Google 文檔進行創建、讀取、更新和刪除等操作，同時還具備導出、共享和搜索等實用功能。

🚀 快速開始

Google Docs MCP 服務器為您與 Google 文檔 API 的交互提供了便捷途徑。您可以通過一系列命令輕鬆實現對 Google 文檔的各種操作。

✨ 主要特性

• 支持對 Google 文檔進行創建、讀取、更新和刪除操作。
• 具備文檔導出、共享和搜索功能。
• 提供多種認證方式，包括使用 Google Cloud Project ID 和 Service Account Key JSON、API Key 以及 OAuth 2.0。
• 支持 Docker 部署，方便快捷。
• 可集成到 Claude 或其他支持 MCP 的助手中。

📦 安裝指南

安裝依賴項

使用以下命令安裝所需的依賴項：

npm install

運行服務器

運行服務器：

node dist/index.js

🔧 認證配置

要與 Google Docs API 交互，您需要適當的認證信息。以下是支持的幾種認證方式：

1. 使用 Google Cloud Project ID 和 Service Account Key JSON

• 參數:
  • GOOGLE_CLOUD_PROJECT_ID：您的 Google Cloud 項目 ID。
  • GOOGLE_APPLICATION_CREDENTIALS：包含您的服務賬戶密鑰的 JSON 文件路徑。

    export GOOGLE_CLOUD_PROJECT_ID=your-project-id
    export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
    

2. 使用 API Key

• 參數:
  • GOOGLE_API_KEY：您的 Google API 密鑰。

    export GOOGLE_API_KEY=your-api-key
    

3. 使用 OAuth 2.0（適用於用戶認證）

• 參數:
  • client_id：您的應用客戶端 ID。
  • client_secret：您的應用客戶端密鑰。
  • refresh_token：用戶的刷新令牌。

    export client_id=your-client-id
    export client_secret=your-client-secret
    export refresh_token=your-refresh-token
    

🐳 Docker 支持

構建鏡像

docker build -t google-docs-mcp-server .

運行容器

docker run -p 8080:8080 \
  -e GOOGLE_CLOUD_PROJECT_ID=your-project-id \
  -e GOOGLE_APPLICATION_CREDENTIALS_JSON='{"type":"service_account","project_id":"..."}' \
  -e client_id=your-client-id \
  -e client_secret=your-client-secret \
  -e refresh_token=your-refresh-token \
  -e AUTH_SERVER_URL=https://your-auth-server.com/verify \
  google-docs-mcp-server

🔌 MCP 集成

要在 Claude 或其他支持 MCP 的助手中使用此服務器，將其添加到 MCP 設置：

{
  "mcpServers": {
    "google-docs": {
      "command": "node",
      "args": ["/path/to/google-docs-mcp-server/dist/index.js"],
      "config": {
        "GOOGLE_CLOUD_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account-key.json"
      }
    }
  }
}

🛠️ 可用工具

以下是可通過服務器進行的操作：

💻 使用示例

基礎用法

創建新文檔

{
  "command": "createDocument",
  "params": {
    "documentTitle": "My New Document",
    "body": "This is the content of the new document."
  }
}

更新現有文檔

{
  "command": "updateDocument",
  "params": {
    "id": "1234567890abcdefghijklmnopqrstuvwxyz",
    "newBody": "Updated content of the document."
  }
}

📄 許可證

本項目採用 MIT 許可證，詳情請查閱 LICENSE 文件。