Googlesheet MCP

🚀 Google Sheets MCP サーバー

この MCP サーバーは、Google スプレッドシートとのやり取りを可能にするツールを提供します。電子スプレッドシート内のデータを読み取り、書き込み、更新することができます。

🚀 クイックスタート

この MCP サーバーを使用することで、Google スプレッドシートとのやり取りが容易になります。以下の手順に沿ってセットアップし、データの操作を始めましょう。

✨ 主な機能

• Google スプレッドシート内のデータの読み取り、書き込み、更新が可能。
• コマンドラインインターフェースを通じて簡単に操作できる。

📦 インストール

前提条件

• 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" をクリックします。
   • サービスアカウントの詳細を入力します。
     • 名前：説明的な名前を選択します。
     • ID：自動生成されます。
     • 説明：任意の説明を入力します。
   • "Create and Continue" をクリックします。
   • ロールとして "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" アクセス権限を付与します。

MCP サーバーのインストール

1. MCP サーバーをダウンロードします。

git clone https://github.com/YOUR_REPO/mcp-server.git
cd mcp-server

2. 依存関係をインストールします。

pip install -r requirements.txt

3. MCP サーバーを起動します。

python server.py

💻 使用例

基本的な使用法

以下は、MCP サーバーを使用した基本的なコマンドの例です。

コマンド一覧

mcp list-commands

スプレッドシートのデータを取得する

mcp get-table --spreadsheet_id YOUR_SPREADSHEET_ID --sheet_name YOUR_SHEET_NAME

新しいレコードを追加する

mcp add-record --spreadsheet_id YOUR_SPREADSHEET_ID --sheet_name YOUR_SHEET_NAME --data "value1,value2\nvalue3,value4"

レコードを更新する

mcp update-record --spreadsheet_id YOUR_SPREADSHEET_ID --sheet_name YOUR_SHEET_NAME --identifier RECORD_IDENTIFIER --updates "column1=value1\ncolumn2=value2"

🔧 技術詳細

この MCP サーバーは、Google Sheets API を使用して Google スプレッドシートと通信します。Python の google-auth-oauthlib、google-auth-httplib2、google-api-python-client ライブラリを利用して、認証と API 呼び出しを行います。

📚 ドキュメント

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

認証情報の管理

• credentials.json をバージョン管理システムから除外します。
• 定期的に認証情報を更新します。
• 必要なサービスアカウントのみに Google スプレッドシートを共有します。

権限管理

• サービスアカウントのメールアドレスがスプレッドシートに編集者として追加されていることを確認します。
• credentials.json ファイルの有効性と安全性を検証します。

データ保護

• 重要なデータを定期的にバックアップします。
• 機密情報の転送には HTTPS を使用します。
• 関連するプライバシー規制とポリシーを遵守します。

トラブルシューティング

一般的な問題

認証エラー

• サービスアカウントのメールアドレスがスプレッドシートに編集者として追加されていることを確認します。
• credentials.json ファイルの有効性と完全性を検証します。
• Google Sheets API が Google Cloud プロジェクトで有効になっていることを確認します。

権限エラー

• サービスアカウントが正しい権限を持っていることを確認します。
• スプレッドシートがサービスアカウントのメールアドレスと共有されていることを検証します。
• スプレッドシートの ID が正しいことを確認します。

データ形式エラー

• データ形式が予想される構造に一致していることを確認します。
• スプレッドシートに必要な列（id または名前）があることを確認します。
• データの列数がスプレッドシートと一致していることを検証します。

連絡先

何か問題や質問がある場合は、以下の手順を試してください。

1. ログ内のエラーメッセージを確認します。
2. 設定が上記の説明に沿っていることを検証します。
3. すべての前提条件が満たされていることを確認します。
4. aryanpandit17032002@gmail.com に連絡します。