Google Docs MCP Server

🚀 Google Docs MCP サーバー

Google Docs MCP サーバーは、Google ドキュメント API とのやり取りを行うためのミドルウェアプラットフォームです。コマンドを使用して、Google ドキュメントの作成、読み取り、更新、削除などの操作を行うことができ、同時にエクスポート、共有、検索機能もサポートしています。

🚀 クイックスタート

Google Docs MCP サーバーを使用することで、Google ドキュメント API とのやり取りを簡単に行うことができます。以下に、基本的なセットアップと使用方法を説明します。

✨ 主な機能

• Google ドキュメントの作成、読み取り、更新、削除操作をサポート
• ドキュメントのエクスポート、共有、検索機能を提供
• 複数の認証方式（Google Cloud Project ID、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 ファイルを参照してください。