GoogleSheet MCP

Google Sheets MCP サーバー

この MCP サーバーは、Google Sheets と連携するためのツールを提供し、スプレッドシート内のデータの読み取り、書き込み、更新を行えます。

前提条件

• Python 3.8 以降
• Google Cloud Platform アカウント
• 連携する Google スプレッドシート

インストール

1. このリポジトリをクローンします：

git clone <your-repository-url>
cd mcp-server-demo

2. 必要なパッケージをインストールします：

pip install google-auth-oauthlib google-auth-httplib2 google-api-python-client

3. credentials.json をダウンロードして配置します：
   • Google Cloud Console から credentials.json ファイルをダウンロードします
   • credentials.json ファイルを main.py と同じディレクトリに配置します
   • ファイル名が正確に credentials.json になっていることを確認します

Google Cloud Platform の認証情報の設定

1. Google Cloud Console にアクセスします

2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します

3. Google Sheets API を有効にします：

   • 「APIs & Services」>「Library」に移動します
   • 「Google Sheets API」を検索します
   • 「Enable」をクリックします

4. 認証情報を作成します：

   • 「APIs & Services」>「Credentials」に移動します
   • 「Create Credentials」>「Service Account」をクリックします
   • サービスアカウントの詳細を入力します：
     • Name：わかりやすい名前を選択します
     • ID：自動的に生成されます
     • Description：任意の説明を入力します
   • 「Create and Continue」をクリックします
   • Role で「Editor」（または必要に応じたロール）を選択します
   • 「Continue」をクリックし、続いて「Done」をクリックします

5. キーを作成してダウンロードします：

   • サービスアカウントの一覧で、新しく作成したアカウントをクリックします
   • 「Keys」タブに移動します
   • 「Add Key」>「Create new key」をクリックします
   • 「JSON」形式を選択します
   • 「Create」をクリックします
   • JSON ファイルが自動的にダウンロードされます

6. 認証情報を保存します：

   • ダウンロードした JSON ファイルの名前を credentials.json に変更します
   • mcp-server-demo ディレクトリに配置します

7. Google スプレッドシートを共有します：

   • Google スプレッドシートを開きます
   • 「Share」ボタンをクリックします
   • サービスアカウントのメールアドレス（credentials.json の client_email フィールドに記載されています）を追加します
   • 「Editor」アクセス権を付与します

サーバーの実行

1. MCP サーバーをインストールします：

uv run mcp install main.py

2. サーバーが起動し、コマンドを受け付ける準備が整います。

Cursor への追加

この MCP サーバーを Cursor に追加するには、次の手順に従います：

1. Cursor を開きます
2. Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server に移動します
3. 次の設定を Cursor の設定ファイルに追加します：

{
  "mcpServers": {
    "GoogleSheets": {
      "command": "python",
      "args": [
        "main.py"
      ]
    }
  }
}

4. 変更を反映するために Cursor を再起動します

スクリーンショット

利用可能なツール

スプレッドシートの一覧表示

/tool list_spreadsheets

サービスアカウントと共有されているすべてのスプレッドシートを一覧表示します。

スプレッドシート情報の取得

/tool get_spreadsheet_info "spreadsheet_id"

特定のスプレッドシートに関する情報を取得します。

シートの内容の取得

/tool get_sheet_content "spreadsheet_id"

特定のシートの内容を取得します。

シートデータの生成

/tool generate_sheet_data "spreadsheet_id"  number_of_records

シートの属性に基づいて、現実的なデータを生成します。

シートへのデータ追加

/tool add_data_to_sheet "spreadsheet_id"  "data_string"

事前に生成したデータをシートに追加します。

シートレコードの更新

/tool update_sheet_record "spreadsheet_id"  "identifier" "updates"

ID または名前の一致に基づいて、シート内のレコードを更新します。

データ形式

データ追加の場合

データ文字列は、次のいずれかの形式にできます：

1. リストのリスト形式：[["value1", "value2"], ["value3", "value4"]]
2. CSV 形式：

value1,value2
value3,value4

更新の場合

変更内容は次の形式で指定します：column1=value1 column2=value2 例：age=25 [email protected] phone=1234567890

セキュリティに関する注意事項

1. credentials.json をバージョン管理にコミットしないでください
2. 認証情報を安全に保管してください
3. 必要なサービスアカウントとのみ Google スプレッドシートを共有してください
4. 認証情報を定期的にローテーションしてください

トラブルシューティング

よくある問題

1. 認証エラー

   • サービスアカウントのメールアドレスが、スプレッドシートの編集者として追加されていることを確認してください
   • credentials.json ファイルが有効で、破損していないことを確認してください
   • Google Cloud プロジェクトで Google Sheets API が有効になっているか確認してください

2. 権限エラー

   • サービスアカウントに適切な権限が付与されていることを確認してください
   • スプレッドシートがサービスアカウントのメールアドレスと共有されていることを確認してください
   • スプレッドシート ID が正しいか確認してください

3. データ形式エラー

   • データ形式が想定される構造と一致していることを確認してください
   • シートに必要な列（id または name）があるか確認してください
   • データの列数がシートの列数と一致していることを確認してください

サポート

問題が発生した場合やご質問がある場合は、次の手順をお試しください。

1. ログのエラーメッセージを確認します
2. 上記の手順に従ってセットアップを確認します
3. 前提条件がすべて満たされていることを確認します
4. [email protected] までお問い合わせください