Claude-GAS-Bridge

Claude-GAS-Bridge

Node.js を用いて、MCP (Model Context Protocol) クライアント（例: Claude Desktop）と GAS Interpreter（Google Apps Script 側）を接続するブリッジサーバーです。
bridge.mjs 内で @modelcontextprotocol/sdk の MCP サーバーを起動し、GAS のWebエンドポイントへ HTTP POST する機能を提供します。

構成概要

• bridge.mjs
  MCPサーバー本体。execute-gas というツールを定義し、クライアントから受け取ったGASスクリプトを指定の WebApp（Apps Script）エンドポイントへ転送します。
  ツール呼び出し時、タイトル・スクリプト本文・APIキーを JSON で送信する形です。

必要環境

• Node.js 18 以上
  @modelcontextprotocol/sdk が Node 18 以降を推奨しています
• GAS Interpreter のデプロイ済み
  Google Apps Script で GAS Interpreter を正しくデプロイし、ウェブアプリのURLを取得しておく
• （オプション）Claude Desktop 等、MCP クライアント

セットアップ

1. ソースを取得
   git clone <このリポジトリのURL> cd claude-gas-bridge
2. 依存パッケージをインストール
   npm install
   ※ Yarn でも可
3. GASのデプロイURLを設定
   bridge.mjs 内の GAS_ENDPOINT を、実際のApps ScriptのURLに書き換える。
   例：
   const GAS_ENDPOINT = "https://script.google.com/macros/s/AKfycbxxxxx/exec";
4. Node.js でサーバー起動
   node bridge.mjs
   コンソールに "Bridge server started (Stdio). Waiting for requests..." と表示されたら待機状態となり、MCPクライアントからの呼び出しを受け付けます。

Claude Desktop との連携 (例)

もし Claude Desktop で利用する場合、claude_desktop_config.json に以下のように設定します:

1. Claude Desktop を再起動
2. チャット画面下部のツール一覧（ハンマーアイコン）で execute-gas が見えるはずです
3. 「ChatGPT を通じて GASスクリプトを実行したい」などの指示をすると、bridge.mjs がリクエストを受け、GAS Interpreterに転送します

APIキーの管理について

• GAS Interpreter 側が API キーを要求する場合は、ツール呼び出し時に "apiKey": "..." を指定するか、bridge.mjs 内部で環境変数を参照して埋め込むなど適宜調整してください。