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 请求的功能。

构成概要

claude-gas-bridge/
├─ bridge.mjs               # メインのMCPサーバーコード
├─ package.json
├─ package-lock.json
└─ ... (その他ファイル)

• bridge.mjs
  MCP 服务器主体。定义了一个名为 execute-gas 的工具，该工具将从客户端接收的 GAS 脚本转发到指定的 WebApp（Apps Script）端点。
  在调用工具时，会以 JSON 格式发送标题、脚本正文、API 密钥等信息。

所需环境

• Node.js 18 或更高版本
  @modelcontextprotocol/sdk 推荐使用 Node 18 及以上版本
• 已部署的 GAS Interpreter
  正确地在 Google Apps Script 中部署 GAS Interpreter 并获取 Web 应用程序的 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 文件中按如下方式配置:

{
  "mcpServers": {
    "gas-bridge": {
      "command": "node",
      "args": [
        "/絶対パス/claude-gas-bridge/bridge.mjs"
      ]
    }
  }
}

1. 重启 Claude Desktop
2. 在聊天界面底部的工具列表（锤子图标）中应该能看到 execute-gas
3. 当给出“希望通过 ChatGPT 执行 GAS 脚本”之类的指示时，bridge.mjs 将接收请求并将其转发给 GAS Interpreter

关于 API 密钥管理

• 如果 GAS Interpreter 需要 API 密钥，请在调用工具时指定 "apiKey": "..."，或者根据需要在 bridge.mjs 内部引用环境变量进行嵌入调整。