Google Sheets MCP Server

Google Sheets MCP サーバー

Go で記述された Google Sheets 用の Model Context Protocol（MCP）サーバーです。Google スプレッドシートを操作するための包括的なツールを提供します。

特徴

• シートデータ：セルデータや数式の取得・更新、バッチ操作
• シート管理：シートの作成、名前変更、コピー、行・列の追加
• スプレッドシート管理：スプレッドシートの作成、一覧表示、共有
• 複数の認証方法：サービスアカウント、OAuth2、ADC

クイックスタート

1. ビルド：

   make build
   

2. Google API の認証情報を設定する（詳しい手順は SETUP.md を参照してください）

3. 環境を設定する：

   # Service Account (recommended)
   export SERVICE_ACCOUNT_PATH="path/to/service-account.json"
   
   # OAuth2
   export CREDENTIALS_PATH="path/to/credentials.json"
   
   # Base64 encoded service account
   export CREDENTIALS_CONFIG="base64_encoded_service_account_json"
   

4. 実行：

   # Stdio mode
   ./go_mcp_server_google_sheets
   
   # SSE mode
   ./go_mcp_server_google_sheets -t sse -p 8891
   

環境変数

• SERVICE_ACCOUNT_PATH - サービスアカウントの JSON ファイルへのパス
• CREDENTIALS_PATH - OAuth2 認証情報の JSON ファイルへのパス
• CREDENTIALS_CONFIG - Base64 エンコードされたサービスアカウント JSON
• TOKEN_PATH - OAuth2 トークンの保存先パス（デフォルト：token.json）
• DRIVE_FOLDER_ID - 新しいスプレッドシートを作成する Google Drive フォルダー ID

利用可能なツール

データ操作

• get_sheet_data - シートからデータを取得
• get_sheet_formulas - シートから数式を取得
• update_cells - セルの値を更新
• batch_update_cells - 複数の範囲を一括更新

シート管理

• list_sheets - スプレッドシート内のすべてのシートを一覧表示
• create_sheet - 新しいシートを作成
• rename_sheet - 既存のシートの名前を変更
• copy_sheet - スプレッドシート間でシートをコピー
• add_rows / add_columns - 行または列を追加

スプレッドシート管理

• create_spreadsheet - 新しいスプレッドシートを作成
• list_spreadsheets - Drive 内のスプレッドシートを一覧表示
• share_spreadsheet - スプレッドシートをユーザーと共有

認証の設定

方法 1：サービスアカウント（推奨）

1. Google Cloud プロジェクトを作成する：

   • Google Cloud Console にアクセスします
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します

2. API を有効にする：

   • 「APIs & Services」>「Library」に移動します
   • 「Google Sheets API」を有効にします
   • 「Google Drive API」を有効にします

3. サービスアカウントを作成する：

   • 「APIs & Services」>「Credentials」に移動します
   • 「Create Credentials」>「Service Account」をクリックします
   • サービスアカウントの詳細を入力します
   • 「Create and Continue」をクリックします

4. キーを生成する：

   • 作成したサービスアカウントをクリックします
   • 「Keys」タブに移動します
   • 「Add Key」>「Create new key」をクリックします
   • 「JSON」形式を選択します
   • ファイルをダウンロードします（これが service-account.json です）

5. 環境変数を設定する：

   export SERVICE_ACCOUNT_PATH="/path/to/your/service-account.json"
   

方法 2：OAuth2（ユーザーアクセス用）

1. OAuth2 認証情報を作成する：

   • Google Cloud Console で、「APIs & Services」>「Credentials」に移動します
   • 「Create Credentials」>「OAuth client ID」をクリックします
   • 「Desktop application」を選択します
   • JSON ファイルをダウンロードします（これが credentials.json です）

2. 環境変数を設定する：

   export CREDENTIALS_PATH="/path/to/your/credentials.json"
   

方法 3：Base64 エンコード（コンテナ／CI 用）

1. サービスアカウントをエンコードする：

   base64 -w 0 /path/to/service-account.json
   

2. 環境変数を設定する：

   export CREDENTIALS_CONFIG="your_base64_encoded_string_here"
   

サービスアカウントとのスプレッドシートの共有

サービスアカウントを使用する場合、スプレッドシートをサービスアカウントのメールアドレスと共有する必要があります。

1. Google スプレッドシートを開きます
2. 「Share」ボタンをクリックします
3. サービスアカウントのメールアドレスを追加します（JSON ファイル内の client_email で確認できます）
4. 適切な権限（閲覧者／編集者）を付与します

ライセンス

MIT