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で以下のAPIが有効になっていることを確認してください。

1. ドキュメントAI API
2. ドライブAPI

テストユーザーの追加

OAuthコンソール画面で、あなたのメールアドレスをテストユーザーとして追加してください。

💻 使用例

プロジェクトのビルド

以下のコマンドを実行して、プロジェクトをビルドします。

npm run build

サーバーの起動

以下のコマンドを実行して、MCPサーバーを起動します。

node dist/server.js

💻 高度な使用法

• テキストスタイル：applyTextStyleメソッドを使用して、テキスト "Important Section" を太字で赤色 (#FF0000) に設定します。
• 段落スタイル：applyParagraphStyleを使用して、"Title Here" を含む段落を中央揃えにします。
• テーブルの挿入：ドキュメントのインデックス500の位置に3x4のテーブルを挿入します。
• 旧版フォーマット：formatMatchingTextを使用して、2回目に出現する "Project Alpha" を見つけ、青色 (#0000FF) に設定します。

🔒 セキュリティとトークンの保存

• .gitignoreファイル：このリポジトリには、機密ファイル（credentials.jsonとtoken.json）の誤送信を防ぐための.gitignoreファイルが含まれています。これらのエントリを削除しないでください。
• トークンの保存：このサーバーは、設定を簡素化するために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インテリジェントアシスタントを簡単に統合し、様々な複雑なドキュメント操作を実行できます。