Google Sheets MCP Server

# Google Sheets MCP Server Googleスプレッドシートと連携するMCP（Model Context Protocol）サーバーです。 ローカル用です。 ## 機能 - スプレッドシートの読み取り - スプレッドシートへの書き込み - 行の追加 - スプレッドシート情報の取得 - 新しいシートの作成 ## 前提 ``` node -v v24.8.0 ``` ## セットアップ ### 1. 依存関係のインストール ```bash npm install ``` ### 2. Google Cloud認証の設定 1. [Google Cloud Console](https://console.cloud.google.com/)でプロジェクトを作成 2. Google Sheets APIを有効化 3. サービスアカウントを作成し、JSONキーファイルをダウンロード 4. ダウンロードしたキーファイルを`key/`ディレクトリに配置（`mkdir key`） ### 3. ビルド ```bash npm run build ``` ### 4. 起動 ```bash npm run start ``` ## 使用方法 ### Cursorでの使用 `mcp.json`を設定してCursorで使用できます： ```json { "mcp": { "servers": { "google-sheets": { "command": "node", "args": ["プロジェクトまでの絶対パス/dist/index.js"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "プロジェクトまでの絶対パス/key/your-service-account-key.json" } } } } } ``` **重要**: `GOOGLE_APPLICATION_CREDENTIALS`のパスは、ダウンロードしたサービスアカウントキーファイルの実際のパスに変更してください。 **重要**: スプレットシートの右上にある「共有」からサービスアカウントのメールアドレスを追加 ## 利用可能なツール - `read_sheet`: スプレッドシートの指定された範囲のデータを読み取る - `write_sheet`: スプレッドシートの指定された範囲にデータを書き込む - `append_row`: スプレッドシートの最後に新しい行を追加する - `get_sheet_info`: スプレッドシートの基本情報を取得する - `create_sheet`: 新しいシートを作成する ## 注意事項 - サービスアカウントのキーファイルは機密情報です。`.gitignore`に追加して、リポジトリにコミットしないでください - スプレッドシートにアクセスするには、サービスアカウントのメールアドレスをスプレッドシートの共有設定に追加する必要があります - 各利用者は自分のGoogle Cloudプロジェクトでサービスアカウントを作成し、キーファイルをダウンロードする必要があります