项目简介

'Claude-GAS-Bridge' 是一个使用 Node.js 构建的桥梁服务器，旨在连接遵循 MCP (Model Context Protocol) 协议的客户端（例如 Claude Desktop）与 Google Apps Script (GAS) 环境。它允许 MCP 客户端通过调用预定义的工具，在 Google Apps Script 中执行脚本，从而扩展 LLM 应用的功能。

主要功能点

MCP 服务器: 实现了 MCP 协议的服务端，能够接收和处理来自 MCP 客户端的请求。
工具桥接: 定义名为 'execute-gas' 的工具，将客户端对该工具的调用转化为对 Google Apps Script Web 应用的 HTTP POST 请求。
GAS 脚本执行: 允许 MCP 客户端通过 'execute-gas' 工具，向预先部署的 GAS Web 应用发送脚本和相关参数（如标题、API 密钥），从而在 Google Apps Script 环境中执行脚本。

安装步骤

获取代码: 使用 Git 克隆仓库到本地：

git clone https://github.com/KaishuShito/gas-interpreter-mcp.git
cd gas-interpreter-mcp

安装依赖: 在项目根目录下运行 'npm install' 或 'yarn install' 安装所需的 Node.js 依赖包。
```
npm install
```

配置 GAS Web App URL: 编辑 'bridge.mjs' 文件，将 'GAS_ENDPOINT' 变量的值替换为您已部署的 Google Apps Script Web 应用的 URL。

const GAS_ENDPOINT = "https://script.google.com/macros/s/your_gas_webapp_id/exec"; // 替换为你的 GAS Web App URL

启动服务器: 在项目根目录下运行 'node bridge.mjs' 启动 MCP 服务器。
```
node bridge.mjs
```
启动成功后，控制台会显示 '"Bridge server started (Stdio). Waiting for requests..."'，表示服务器已准备就绪，等待 MCP 客户端的连接和请求。

服务器配置

以下是配置 MCP 客户端（如 Claude Desktop）连接到 'gas-bridge' 服务器的示例 JSON 配置。您需要将此配置添加到您的 MCP 客户端的配置文件中。

{
  "mcpServers": {
    "gas-bridge": {
      "command": "node",
      "args": [
        "{repository_path}/bridge.mjs"
      ]
    }
  }
}

'"gas-bridge"': 服务器名称，您可以自定义，用于在 MCP 客户端中标识该服务器。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行环境。
'"args": ["{repository_path}/bridge.mjs"]': 命令参数，指定 'bridge.mjs' 脚本的路径。 请将 '{repository_path}' 替换为 'gas-interpreter-mcp' 仓库在您本地文件系统中的绝对路径。 例如，如果仓库位于 '/Users/yourname/documents/gas-interpreter-mcp'，则应替换为 '/Users/yourname/documents/gas-interpreter-mcp/bridge.mjs'。

基本使用方法

配置 MCP 客户端: 按照上述 “服务器配置” 部分的说明，配置您的 MCP 客户端以连接到 'gas-bridge' 服务器。
调用 'execute-gas' 工具: 在 MCP 客户端中，您可以指示 LLM 调用 'execute-gas' 工具。例如，在 Claude Desktop 中，您可以在聊天对话中输入类似 “请使用 'execute-gas' 工具执行一段 GAS 脚本来...” 的指令。
传递脚本参数: 'execute-gas' 工具通常需要标题、脚本内容以及可能的 API 密钥等参数。具体的参数传递方式取决于您的 MCP 客户端和 GAS Interpreter 的实现。请参考相关文档进行配置和使用。
查看执行结果: 脚本执行完成后，结果将通过桥梁服务器返回给 MCP 客户端，并在客户端界面中显示。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息