项目简介
'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任务,简化交互流程。
安装步骤
- 前提条件: 确保已安装 Google Gemini CLI。
- 安装扩展: 通过Gemini CLI安装此扩展,命令如下:
gemini extensions install https://github.com/mhawksey/gas-fakes-ext - 启动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'):
生成的'run.js'文件可以被MCP服务器提供的'run-gas-fakes-test'工具在安全的沙盒环境中执行。/gas:new "创建一个新的Google文档并写入'Hello, World!'"
信息
分类
开发者工具