项目简介

'gas-fakes-ext' 是一个用于Gemini CLI的扩展,它提供了一个安全、沙盒化的环境,用于本地开发和测试Google Apps Script (GAS) 项目。它利用 'gas-fakes' 库创建一个安全的沙盒,隔离AI生成的代码,避免其直接访问您的Google账户和数据,从而降低安全风险。此扩展还包含一个MCP服务器,允许Gemini CLI通过该服务器与沙盒化的GAS环境进行交互,实现Google Workspace任务的会话式自动化。

主要功能点

  • 安全沙盒执行: 在本地安全地运行Google Apps Script代码,无需授予其对Google账户的任何权限。
  • 本地开发与测试: 支持在本地机器上开发和测试GAS项目,提高开发效率和安全性。
  • AI代码友好: 专门为实验AI生成的Google Apps Script代码设计,无需担心潜在的安全风险。
  • MCP服务器集成: 提供一个本地Model Context Protocol (MCP) 服务器,使Gemini CLI能够发现并调用沙盒化的GAS执行能力。
  • 会话式自动化: 允许通过自然语言指令,利用LLM(如Gemini)自动执行Google Workspace任务,简化交互流程。

安装步骤

  1. 前提条件: 确保已安装 Google Gemini CLI
  2. 安装扩展: 通过Gemini CLI安装此扩展,命令如下:
    gemini extensions install https://github.com/mhawksey/gas-fakes-ext
  3. 启动Gemini: 导航到您的工作目录并启动Gemini,此操作会激活已安装的扩展:
    gemini

服务器配置

此扩展包含一个作为本地进程运行的MCP服务器。当通过Gemini CLI安装和使用此扩展时,Gemini CLI会自动管理其生命周期和与它的连接。

MCP客户端(例如Gemini CLI)通常需要一个JSON格式的配置来连接MCP服务器。对于这个扩展,MCP服务器的配置大致如下(客户端通常会自动处理这些细节):

{
  "name": "MCP server for gas-fakes",
  "command": "node",
  "args": [
    "path/to/gas-fakes-ext/mcp/gas-fakes-mcp.js"
  ],
  "description": "通过MCP协议,提供在安全沙盒中执行Google Apps Script的能力。",
  "version": "1.0.0",
  "transport": "stdio"
}
  • 'name': MCP服务器的标识名称。
  • 'command': 启动MCP服务器的可执行命令,通常是 'node'。
  • 'args': 传递给命令的参数列表,其中包含MCP服务器脚本的实际路径。
  • 'description': 服务器的功能描述,方便客户端理解其用途。
  • 'version': 服务器的版本号。
  • 'transport': 服务器使用的传输协议,此处为'stdio'(标准输入输出)。

基本使用方法

安装扩展后,可以在Gemini提示符中直接使用 '/gas' 命令空间提供的命令,与沙盒化的Google Apps Script环境进行交互。

  • 初始化Google Apps Script项目: 在当前目录初始化一个新的Google Apps Script项目,创建必要的文件和目录结构:
    /gas:init
  • 根据提示生成沙盒脚本: 根据您的自然语言提示,生成Google Apps Script文件 ('src/Code.js') 和对应的运行脚本 ('run.js'):
    /gas:new "创建一个新的Google文档并写入'Hello, World!'"
    生成的'run.js'文件可以被MCP服务器提供的'run-gas-fakes-test'工具在安全的沙盒环境中执行。

信息

分类

开发者工具