Google Spreadsheets

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

このプロジェクトは、Google スプレッドシートのデータにアクセスするための Model Context Protocol (MCP) サーバーです。LLM が直接スプレッドシートの情報を利用できるようにします。

✨ 主な機能

• ワークシートの基本情報（ワークシートリストなど）の取得
• 特定のワークシートデータの取得と Markdown 形式での整理
• MCP クライアント（Desktop Claude など）との統合

📦 インストール

# リポジトリをクローンする
git clone https://github.com/your-username/spreadsheet-mcp-server.git
cd spreadsheet-mcp-server

# 依存関係をインストールする
npm install

# サンプル環境ファイルをコピーする
cp .env.example .env
# .env ファイルを編集して、GAS_WEB_APP_URL と GAS_API_KEY を設定する

# プロジェクトをビルドする
npm run build

🔧 環境変数の設定

サーバーを実行するために必要な環境変数は次のとおりです。

• GAS_WEB_APP_URL: Google Apps Script Web App の URL アドレス
• GAS_API_KEY: Google Apps Script Web App へのアクセス用 API キー

これらの環境変数は .env ファイルで設定できます。

GAS_WEB_APP_URL=https://script.google.com/macros/s/your-deployment-id/exec
GAS_API_KEY=your-api-key

環境変数が設定されていない場合、サーバーはシミュレーションモードで実行され、実際に Google スプレッドシートにアクセスすることはありません。

💻 使用例

基本的な使用法

npm start

高度な使用法

Desktop Claude と統合するには、Desktop Claude の設定ファイル (claude_desktop_config.json) に以下の内容を追加します。

{
  "mcpServers": {
    "spreadsheet": {
      "command": "node",
      "args": ["<absolute-path-to-project>/build/index.js"]
    }
  }
}

環境変数を設定する場合は、env フィールドを次のように追加します。

{
  "mcpServers": {
    "spreadsheet": {
      "command": "node",
      "args": ["<absolute-path-to-project>/build/index.js"],
      "env": {
        "GAS_WEB_APP_URL": "https://script.google.com/macros/s/your-deployment-id/exec",
        "GAS_API_KEY": "your-api-key"
      }
    }
  }
}

設定ファイルのパスは次のとおりです。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %AppData%\\Claude\\claude_desktop_config.json

📚 動作確認

npm test

📄 ライセンス

MIT