Clasp

官方

在命令行中本地开发和管理 Google Apps Script 项目

分类: 开发工具第 74 / 438
Stars: ★ 5.9k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 22+
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 2 个月前

63FMRS · C

clasp 是 Google 官方仓库维护、面向 Apps Script 的本地开发命令行工具，其实验性的 clasp mcp 子命令通过 STDIO 暴露给编码代理复用现有 CLI 凭据。功能覆盖项目推拉、部署、版本、日志和 API 管理，但 MCP 工具集有限且仍在迭代中，同时 OAuth 授权范围较广、push 为整体覆盖操作，需要谨慎管理凭据并留意远程覆盖风险。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

13/20

维护活跃度

15/20

文档质量

15/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: README 中仅有一枚 CI 徽章链接和一个指向 coveralls 的覆盖率徽章,但未提供实际工作流文件内容或测试用例的可核实证据,manifest 未缓存,因此无法确认已声明的 MCP 工具与真实行为是否一致。MCP 模式被作者明确标注为「EXPERIMENTAL」,且「目前仅提供有限的一部分工具供 agent 使用,欢迎反馈」,这直接说明该功能尚不完整、稳定性存疑。按静态评审口径,没有可验证的 CI 工作流与已提交测试覆盖服务器关键路径的证据,分数不得高于 12,故给出 8 分。
安全与权限 13/20: 认证采用标准 OAuth 流程,凭据保存在用户主目录下的 .clasprc.json,支持多用户(--user)及自带 OAuth 客户端以提升合规性,这些是积极信号。但文档列出的完整 OAuth 范围包含极宽泛的 https://www.googleapis.com/auth/cloud-platform,不符合最小权限原则。delete-script、delete-deployment 等破坏性操作默认有确认提示(--force 可跳过,已提示风险)。push 命令会默认整体覆盖远程脚本内容而不需要额外确认,虽然文档以醒目「Warning」提前披露,但仍是潜在数据覆盖风险。service account/ADC 功能被标注为「EXPERIMENTAL/NOT WORKING」,诚实披露但也说明该路径不可靠。综合来看主要风险可见且有部分确认机制和披露,但权限收窄、二次确认覆盖不完整,未达到红线级别,故为 13 分。
维护活跃度 15/20: 仓库归属 google 组织,使用 Apache-2.0 许可证,star 数 5778,open issue 53,未被归档,存在明确的 2.x→3.x 迁移指南及近期新增的 Gemini/Claude Code MCP 扩展支持,表明项目仍在积极演进。但所给材料中未见明确的安全响应渠道(如 SECURITY.md)、版本发布节奏或 CODEOWNERS 信息,治理层面的证据不足,故未给满分。
文档质量 15/20: README 内容详尽,涵盖安装、认证(含自带凭据、允许列表、服务账号)、完整命令参考(含参数与示例)、.clasp.json/.claspignore 配置说明、故障排查(Node 版本、DEBUG 日志、代理设置)以及迁移指南,层次分明且示例充分。但作为本次评审对象的 MCP 模式相关文档非常单薄——只有一句话描述加「Options: N/A」,没有列出具体工具名称、参数、返回格式或使用限制,且核心的 manifest 未缓存,无法核实工具行为,这是明显的文档缺口,故未给更高分。
安装易用性 12/20: 提供了清晰的 npm 全局安装步骤,并说明需要在 Google 后台手动启用 Apps Script API(外部 GUI 步骤),随后需执行 clasp login 完成 OAuth 授权。针对 MCP 场景,提供了 Claude Code 插件安装、`claude mcp add` 命令行方式以及引用 claude-mcp.json 配置文件三种途径,覆盖主流客户端配置示例。但整体流程仍依赖多个人工/外部步骤(启用 API、OAuth 交互登录),且缺乏实际执行证据验证该流程的可靠性,按静态评审要求分数不得高于 15,综合给出 12 分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络修改第三方账户数据

适合谁

需要在本地工具链（Git、编辑器）中开发 Google Apps Script 的开发者
希望为脚本项目建立版本控制和多人协作流程的团队
希望让 AI 编码代理（Claude Code、Gemini CLI）直接管理 Apps Script 项目的用户

不适合谁

非 Apps Script 的通用云存储或数据库集成需求
需要官方厂商 SLA 支持的场景（README 明确声明这不是 Google 官方支持的产品）
依赖 clasp 2.x 内置 TypeScript 转译的项目（3.x 已移除，需自行使用 Rollup 等打包器）
希望使用服务账号免交互认证的场景（README 标注该功能为实验性且当前不可用）

所需权限

Google OAuth 授权，用于读写用户的 Apps Script 项目（script.projects、script.deployments、script.webapp.deploy 等作用域）
Google Drive 只读元数据及文件访问权限（drive.metadata.readonly、drive.file），用于列出和创建绑定脚本
Google Cloud Service Usage API 权限，用于列出/启用/禁用高级服务 API
Cloud Logging 读取权限，用于拉取脚本运行日志
本地凭据文件 `.clasprc.json`（含 OAuth 令牌）存储在用户主目录或工作目录中

风险与副作用

`clasp push` 会整体覆盖远程项目内容（Apps Script API 不支持原子或单文件级操作），误操作可能导致远程代码丢失
OAuth 授权范围较广，涵盖脚本、Drive 文件、日志和 API 管理，凭据泄露风险较高，尤其是使用 `--creds` 保存的自定义凭据文件
MCP 模式为实验性功能，README 明确说明目前仅提供有限工具集，行为可能变化
服务账号（Application Default Credentials）支持被标注为“实验性/尚不可用”，不应用于生产自动化流程

安装接入

准备工作

运行环境：Node.js 22+

其他可选配置项（3 个）

DEBUG 可选设为 clasp:* 可启用详细调试日志，用于排查问题。

HTTP_PROXY 可选 HTTP 代理地址，经由 Google APIs Node 模块支持，用于受限网络环境。

HTTPS_PROXY 可选 HTTPS 代理地址，经由 Google APIs Node 模块支持，用于受限网络环境。

1) 全局安装：npm install -g @google/clasp；2) 在 https://script.google.com/home/usersettings 启用 Google Apps Script API；3) 运行 clasp login 完成 OAuth 授权（MCP 模式复用该凭据）；4) 作为 MCP 服务器接入编码代理，可选择：Claude Code 中运行 /plugin install @google/clasp 安装插件，或手动执行 claude mcp add clasp -- npx -y @google/clasp mcp（也可用仓库自带的 claude-mcp.json 通过 claude mcp add-json 添加）；Gemini CLI 中运行 gemini extensions install https://github.com/google/clasp。

.mcp.json

{"mcpServers":{"clasp":{"command":"npx","args":["-y","@google/clasp","mcp"]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "clasp": {
      "command": "npx",
      "args": [
        "-y",
        "@google/clasp",
        "mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add clasp -- npx -y @google/clasp mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

先运行 clasp login 完成授权，然后在 MCP 客户端中确认 clasp 服务器的工具已出现；尝试让它列出你的脚本即证明连接成功。

常见排障

确认 Node.js 版本 >= 22.0.0（`node -v` 检查，可用 `npx n latest` 升级）
确认已在 Google Cloud 项目中启用 Apps Script API，并已成功执行 `clasp login`
MCP 服务器无响应或凭据错误时，先确认对应用户的 `.clasprc.json` 是否有效，必要时用 `--user` 指定具体账号重新登录
排查问题时可设置环境变量 `DEBUG=clasp:*` 获取详细调试日志
推送/拉取异常时检查 `.clasp.json` 中的 `scriptId`、`rootDir` 等配置是否正确，以及 `.claspignore` 规则是否误排除了文件

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的 Apps Script 项目
把当前目录的文件推送到我的 Apps Script 项目
为我的脚本创建一个新的部署版本
运行脚本里的 sendEmail 函数

使用场景

将 Apps Script 项目代码纳入本地版本控制并与团队协作开发

通过命令行推送/拉取脚本文件、管理部署和版本

远程执行 Apps Script 函数并查看运行日志

让 AI 编码代理通过 MCP 直接读写和部署 Apps Script 项目

支持客户端

Claude Code

Gemini CLI

依据项目文档列出，未经本站实测。

详细介绍

clasp（Command Line Apps Script Projects）是 Google 官方仓库维护的命令行工具，用于在本地开发 Google Apps Script 项目：支持推送/拉取代码、创建和管理部署与版本、远程执行脚本函数、查看 Stackdriver 日志、以及启用/禁用 Google API。3.x 版本新增了实验性的 clasp mcp 模式，可作为基于 STDIO 传输的本地 MCP 服务器运行，供 Claude Code、Gemini CLI 等编码代理调用，使用与 CLI 相同的已保存凭据（需预先执行 clasp login）。README 明确声明本项目“不是 Google 官方支持的产品”，MCP 功能目前仅提供有限的一部分工具集。