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 웹 엔드포인트로 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 내부에서 환경 변수를 참조해 포함하는 등 적절하게 조정해 주세요.