Spreadsheet MCP Server

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

このプロジェクトは、Model Context Protocol (MCP) を通じて Google スプレッドシートのデータにアクセスするサーバーです。これにより、LLM が直接スプレッドシートの情報を利用することが可能になります。

🚀 クイックスタート

このサーバーを使用することで、Google スプレッドシートのデータにアクセスし、その情報を 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

📚 ドキュメント

環境変数の設定

サーバーを実行するために必要な環境変数は以下の通りです。

これらの変数は .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 と統合する場合

claude_desktop_config.json 設定ファイルに以下の内容を追加します。

{
  "mcpServers": {
    "spreadsheet": {
      "command": "node",
      "args": ["<プロジェクトの絶対パス>/build/index.js"]
    }
  }
}

env フィールドを使用して環境変数を設定することもできます。

{
  "mcpServers": {
    "spreadsheet": {
      "command": "node",
      "args": ["<プロジェクトの絶対パス>/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

MCP Inspector でテストする場合

npx @modelcontextprotocol/inspector node build/index.js

提供されるツール

getSpreadsheet

スプレッドシートの基本情報（ワークシートリストを含む）を取得します。

getSheetData

特定のワークシートのデータを取得し、Markdown 形式で返します。

プロジェクト構成

• api/README.md: Web アプリ API の実装詳細を記述しています。
• その他のファイルやフォルダ（src, public など）は、サーバーの構築と実行に使用されます。

📄 ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。