MCP Server Spreadsheet

🚀 Google スプレッドシート MCP サーバー

Model Context Protocol (MCP) サーバーの実装で、Google スプレッドシートと統合し、AI アシスタントがスプレッドシートのデータを取得および変更できるようにします。このサーバーにより、Claude が直接あなたの Google スプレッドシートのデータとやり取りできます。

🎥 デモ

✨ 主な機能

このサーバーは、Google スプレッドシートを処理するための以下のツールを提供します。

• get_sheets：スプレッドシートのすべてのワークシート情報（名前、次元、ID を含む）を取得します。
• get_sheet_values：特定のワークシートから値を取得し、範囲を指定することもできます。
• update_cells：特定の範囲内のセルの値を更新します。
• batch_update_cells：一度に異なるワークシートの複数の範囲を更新します。
• add_sheet：既存のスプレッドシートにカスタム次元の新しいワークシートを追加します。

📋 前提条件

• Node.js（v18 以上）
• Google スプレッドシート API が有効になっている Google クラウド プロジェクト
• Google クラウドの認証資格情報
• Claude Desktop（Claude との統合に必要）

📦 インストール

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

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

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

   pnpm install
   

🔑 認証設定

このサーバーは、Google クラウドのアプリケーションのデフォルトの資格情報を使用して、Google スプレッドシートにアクセスするための認証を行います。

1. まだインストールしていない場合は、Google Cloud CLI をインストールします。
2. ログインし、Google スプレッドシートへのアクセスを承認します。

   gcloud auth application-default login --scopes=openid,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spreadsheets
   

💡 使用アドバイス

• Google Cloud プロジェクトでスプレッドシート API が有効になっていることを確認してください。
• 認証が完了すると、必要な資格情報ファイルが生成されます。

🛠️ 開発

📁 プロジェクト構造

• src/index.ts：メインエントリポイント
• src/tools/：各 MCP ツールの実装
• src/utils/：ユーティリティ関数とサービス
• src/types/：TypeScript の型定義

🧪 テストの実行

pnpm test

⚙️ 環境変数

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の変数を追加できます。

# オプション：Google API の資格情報パスを上書きする
GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json

# オプション：デバッグモード
DEBUG=true

🐞 トラブルシューティング

• 認証エラー：正しい資格情報が設定されており、Google スプレッドシート API が Google Cloud プロジェクトで有効になっていることを確認してください。
• 権限エラー：Google アカウントまたはサービスアカウントが操作しようとしているスプレッドシートにアクセスする権限を持っていることを確認してください。
• サーバー接続問題：Claude Desktop が MCP サーバーを起動するように正しく構成されていることを確認してください。

📄 ライセンス

MIT

🤝 貢献

貢献を歓迎します！自由に Pull Request を送信してください。