Gemini CLI 集成 Firebase 实战：Agent Skills 扩展安装与 MCP Server 配置指南

Gemini CLI 集成 Firebase 实战Agent Skills 扩展安装与 MCP Server 配置指南【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills本文围绕 firebase-basics 技能中针对 Gemini CLI 的专属环境搭建文档展开介绍两种把 Firebase 能力接入 Gemini CLI 的方式通过官方扩展一次性安装 Agent Skills 与 MCP Server 的推荐路径以及面向单项目的 MCP Server 手动配置路径。读完本文你将掌握在 Gemini CLI 中检查、安装、验证并维护 Firebase 扩展与 MCP Server 的完整命令流程可直接用于自己的代理开发环境。文档定位与适用场景本文讲解的核心文档为 firebase-basics 技能下的 Gemini CLI 安装指南。在 firebase-basics/SKILL.md 的前置条件Prerequisites部分明确要求当 Agent 运行在 Gemini CLI 环境中、且当前仅有firebase-basics一个 Firebase 技能可用时必须先遵循该 setup 文档完成完整 Firebase 技能套件的安装不得跳过。该文档解决的具体问题包括如何判断 Gemini CLI 中是否已经安装了 Firebase 扩展如何通过一条命令同时获得 Firebase Agent Skills 与 Firebase MCP Server当只想在当前项目内使用 MCP Server 时如何用gemini mcp add手动配置安装完成后如何验证、如何重启生效。它适用于在 Gemini CLI命令行 Agent 环境中开发、调试 Firebase 相关功能项目创建、配置拉取、Firestore、Data Connect 等的开发者和 AI Agent 集成工程师。前置条件先完成本地环境自检在配置 Gemini CLI 扩展之前必须先确认基础环境就绪。firebase-basics 的 local-env-setup.md 定义了最低要求且特别强调「未完成以下全部步骤前禁止执行任何其他 Firebase 任务」Node.js 版本运行node --version要求 20。若未安装或版本过低建议通过 nvm / nvm-windows 安装nvm install 24 nvm use 24也可以直接安装官方 LTS 版本。使用版本管理器可以避免全局包安装时的权限问题。Firebase CLI 可用性运行npx -y firebase-toolslatest --version能正常输出版本号即可。Firebase 认证运行npx -y firebase-toolslatest login完成登录对于无浏览器的远程环境改用npx -y firebase-toolslatest login --no-localhost。[!NOTE] 关于登录失败若浏览器无法弹出优先使用--no-localhost参数走手动粘贴授权码的流程这是 SKILL.md 与本地环境文档共同列出的常见问题处理方案。推荐路径通过 Gemini 扩展安装 Firebase 能力Gemini CLI 的官方推荐做法是使用扩展Extension方式。一条扩展安装命令即可同时把两样东西装好Firebase Agent Skills为 Gemini CLI 提供 Firebase 相关的操作技能如firebase-basicsFirebase MCP Server让 Gemini CLI 能够以 MCP 工具的形式直接调用 Firebase 远程 API。1. 检查扩展是否已安装先运行以下命令查看当前已安装的扩展gemini extensions list如果输出中已经包含firebase说明扩展已存在可以直接跳到「重启与验证」步骤。2. 安装 Firebase 扩展如果列表中不存在firebase执行gemini extensions install https://github.com/firebase/agent-skills该命令会从 firebase/agent-skills 仓库拉取扩展包并自动注册对应的 Agent Skills 与 MCP Server 配置。3. 验证安装结果安装完成后通过以下两条命令从两个维度确认验证命令预期输出验证对象gemini mcp list应包含firebase-toolsMCP Server 已注册gemini skills list应包含firebase-basicAgent Skills 已注册[!NOTE] 原文档中 skills 的验证名为firebase-basic。需要留意的是本仓库中对应的技能实际命名为firebase-basics见 SKILL.md 的 front mattername: firebase-basics。由于扩展版本迭代验证时请以gemini skills list的实际输出为准firebase-basic与firebase-basics均属于 Firebase 技能已安装的标识。4. 重启 Gemini CLI只要发生了新的安装就必须重启 Gemini CLI使扩展与 MCP 配置生效。操作指引中特别强调重启前应停下来等待用户确认确认后再继续后续步骤。备选路径项目级手动 MCP 配置如果用户只想在当前项目内使用 Firebase MCP Server不安装完整技能包可以采用手动 MCP 配置方式。该方式作用域为当前项目不依赖扩展安装。1. 检查现有配置运行gemini mcp list若输出已包含firebase-tools说明 MCP Server 已配置直接跳到重启步骤。2. 添加 Firebase MCP Server若未配置执行如下命令gemini mcp add -e IS_GEMINI_CLI_EXTENSIONtrue firebase npx -y firebase-toolslatest mcp逐段拆解这条命令的含义gemini mcp add向 Gemini CLI 的 MCP 配置中添加一个 server-e IS_GEMINI_CLI_EXTENSIONtrue为该 server 注入名为IS_GEMINI_CLI_EXTENSION的环境变量并置为true。从仓库中其他 Agent 环境如 other_agents.md的 MCP 配置示例可以看出普通 Agent 的配置只需command: npxargs: [-y, firebase-toolslatest, mcp]并不需要此变量可以推断该变量用于告知 firebase-tools MCP Server 其运行在 Gemini CLI 扩展上下文中从而启用相应的行为如复用扩展凭证或输出格式firebase该 MCP server 在 Gemini CLI 中的服务名npx -y firebase-toolslatest mcp实际启动命令即通过 npx 拉取最新版 firebase-tools 并运行其内置的mcp子命令与 other_agents.md 中 JSON 配置的启动方式是同一套机制。3. 复验配置重新运行gemini mcp list确认输出中包含firebase-tools且状态为已连接connected。4. 重启 Gemini CLI与扩展方式相同配置变更后需要重启 Gemini CLI并等待用户确认后再继续。两种方式对比与选型建议维度扩展方式推荐手动 MCP 配置备选安装内容Agent Skills MCP Server仅 MCP Server作用范围全局扩展当前项目适用场景需要完整 Firebase 技能编排能力仅需 MCP 工具直连 Firebase关键命令gemini extensions install https://github.com/firebase/agent-skillsgemini mcp add -e IS_GEMINI_CLI_EXTENSIONtrue firebase npx -y firebase-toolslatest mcp验证命令gemini mcp listgemini skills listgemini mcp list选型建议如果你希望在 Gemini CLI 中获得完整的 Firebase 工作流包括 CLI 登录、项目创建/切换、配置文件拉取等技能化操作走扩展方式一步到位如果只是想在某个具体项目里用 MCP 工具查询/操作 Firebase 资源且不想引入额外技能手动配置更轻量。安装完成后的基础验证与日常使用扩展或 MCP 配置就绪后建议按 firebase-basics 技能的标准流程做一轮日常操作验证CLI 版本自检npx -y firebase-toolslatest --version确认能输出版本字符串。登录认证npx -y firebase-toolslatest login远程环境用--no-localhost输出应显示当前登录用户。项目上下文运行npx -y firebase-toolslatest use查看当前激活项目需要切换时执行npx -y firebase-toolslatest use PROJECT_ID。创建新项目npx -y firebase-toolslatest projects:create project-id --display-name display-name。注意project-id需为 630 位小写字母、数字与连字符且全局唯一。自动化拉取配置文件按 SKILL.md 的实操原则iOS / Android 的配置文件应通过 CLI 程序化获取而不是引导用户去控制台下载Androidnpx -y firebase-toolslatest apps:sdkconfig ANDROID APP_ID --project PROJECT_IDiOSnpx -y firebase-toolslatest apps:sdkconfig IOS APP_ID --project PROJECT_ID另外随时可以用npx -y firebase-toolslatest --help查看全部命令或用npx -y firebase-toolslatest [command] --help如deploy --help、firestore:indexes --help查看子命令细节详见 firebase-cli-guide.md。扩展的更新与维护Firebase 的最佳实践演进很快技能与插件需要定期更新。针对 Gemini CLI 环境firebase-basics 提供了专门的刷新指引 refresh/gemini-cli.md其要点是使用 Gemini CLI 原生的扩展管理器而不是npx方式gemini extensions update firebase如果扩展名称不同先从gemini extensions list中获取正确名称再替换firebase。这与本文开头的安装路径保持了一致的管理入口统一走gemini extensions命令族。常见问题排查速查表现象排查与处理gemini extensions list中无firebase扩展未安装执行gemini extensions install https://github.com/firebase/agent-skillsgemini mcp list中无firebase-tools确认扩展安装成功或手动gemini mcp add配置成功然后重启 Gemini CLIgemini skills list中无 Firebase 技能确认扩展安装成功注意技能名可能是firebase-basic或firebase-basics以实际输出为准登录时浏览器无法打开改用npx -y firebase-toolslatest login --no-localhost命令找不到 / 行为异常确认 Node.js 20并始终以npx -y firebase-toolslatest前缀调用以使用最新版 CLI参考文档Gemini CLI 安装指南本文主文档firebase-basics 技能主文档本地环境最低要求Node.js / CLI / 认证Gemini CLI 扩展更新指引其他 Agent 环境的 MCP 配置参考Firebase CLI 命令探索指南【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考