Firebase Agent 本地环境搭建指南基于 firebase-basics Skill 的 Node.js、CLI、认证与 MCP 全流程初始化【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills本篇技术指南以 local-env-setup.md 为核心系统讲解在 Agent如 Gemini CLI、Claude Code、Cursor 等环境中使用 Firebase 之前必须完成的四步最小化环境初始化Node.js 版本验证、Firebase CLI 可用性验证、Firebase 登录认证以及 Agent Skills 与 Firebase MCP Server 的安装。读完本文你将掌握一套可复现、可自检的 Firebase 本地环境初始化流程并了解不同 Agent 环境Gemini CLI、Claude Code、Android Studio、Antigravity、Cursor、GitHub Copilot 及其他 Agent下的具体安装命令与 MCP 配置写法确保后续所有 Firebase 操作建立在可靠的环境基线上。为什么 Agent 使用 Firebase 前必须先完成环境初始化在 firebase-basics 这一 Skill 的定位中本地环境初始化是使用任何 Firebase 功能之前的强制前置步骤。该 Skill 的元数据明确将其职责限定为Firebase CLI 安装与版本检查firebase-toolslatest --version、CLI 登录含--no-localhost、项目创建、项目切换firebase use以及应用配置文件下载google-services.json、GoogleService-Info.plist。因此本文描述的local-env-setup.md是整个 Skill 体系的地基如果 Node.js 缺失、Firebase CLI 无法运行、用户未认证或 MCP Server 未安装后续任何 Firebase 操作部署、查询 Firestore、执行 Data Connect 查询等都将失败或缺少权限上下文。文档末尾有一条CRITICAL AGENT RULE在所有步骤成功验证完成之前Agent 不得继续执行任何其他 Firebase 任务。这条规则对所有开发者同样适用——把它当作一份自动化检查清单来执行即可。第一步验证 Node.js 版本必须 20Firebase CLI 基于 Node.js 运行因此环境初始化的第一件事是确认 Node.js 已安装且版本不低于 20。动作运行node --version。判定若输出版本号且 20通过若 Node.js 缺失或版本 v20则需要根据操作系统完成安装。推荐方式使用 Node 版本管理器nvm文档明确推荐使用 Node Version Managernvm来安装 Node.js理由是避免安装全局包时出现权限问题——通过 nvm 安装的 Node.js 位于用户目录内无需sudo即可执行全局安装例如后续通过 npx 运行 firebase-tools 时不会遇到 EACCES 类错误。macOS / Linux 环境引导用户前往官方 nvm 仓库nvm-sh/nvm 的 Installing and Updating 章节手动安装 nvm。请用户手动完成 nvm 安装后回复确认。注意此处必须停下等待用户确认不要擅自继续。让 nvm 在当前终端会话中生效需要 source 对应的 profile 文件# Bash 环境 source ~/.bash_profile source ~/.bashrc # Zsh 环境 source ~/.zprofile source ~/.zshrc安装并使用 Node.js文档示例使用 24 这个版本该版本满足 20的要求nvm install 24 nvm use 24Windows 环境引导用户下载并安装 nvm-windowscoreybutler/nvm-windows 的 releases 页面。请用户手动安装 nvm-windows 和 Node.js 后回复确认。同样需要停下等待用户确认。用户确认后验证 Node.js 是否可用node --version备选方式官方安装器如果不想使用版本管理器也可以引导用户从 nodejs.org 下载并安装LTS 版本。安装完成后同样需要用户手动确认再继续后续步骤。无论采用哪种方式安装完成后都应以node --version的实际输出来验证而不是仅凭安装过程看起来成功就跳过检查。第二步验证 Firebase CLI 可用性Firebase CLI 在本 Skill 体系中的标准调用方式是通过npx直接运行最新版firebase-tools而不是裸调用全局安装的firebase命令。这样做的目的是始终使用最新版本避免本地缓存了过时版本导致命令行为与文档不一致。命令npx -y firebase-toolslatest --version预期结果成功输出一个版本字符串。参数说明npx随 Node.js 一同安装的包运行工具无需提前全局安装 firebase-tools-y自动确认 npx 对包下载的提示避免交互阻塞firebase-toolslatest指定始终解析最新版本--version输出 CLI 版本号用于验证可执行性。若此命令无法输出版本号说明 Node.js 环境仍有问题通常回到第一步排查或网络无法访问 npm 仓库。第三步验证 Firebase 认证登录要管理 Firebase 项目Agent 必须持有有效的 Firebase 凭据。local-env-setup.md要求执行登录命令完成认证动作运行npx -y firebase-toolslatest login。特殊场景如果运行环境是远程服务器或受限环境无法打开浏览器完成 OAuth 回调改用npx -y firebase-toolslatest login --no-localhost。--no-localhost模式的原理是CLI 打印一个授权链接和一次性验证码引导用户在任意可用的浏览器中打开链接完成授权然后将验证码粘贴回终端完成登录。它专门用于无浏览器或无法回环访问 localhost 的环境。登录成功后在 SKILL.md 的后续流程中npx -y firebase-toolslatest login对应命令会输出当前登录用户可用作认证有效性的二次确认如果未登录CLI 会给出交互式指令引导完成认证。常见的登录问题如浏览器无法自动打开均可回退到--no-localhost解决这一点在 SKILL.md 的 Common Issues 一节中也有明确记载。第四步安装 Agent Skills 与 Firebase MCP Server要完整地管理 FirebaseAgent 除了环境与认证之外还需要两样东西Agent Skills为 Agent 提供 Firebase 相关的工作流指导如本项目中的firebase-basics及配套 SkillFirebase MCP Server通过 Model Context Protocol 让 Agent 直接与 Firebase 项目交互例如获取 Crashlytics 日志、执行 Data Connect 查询。local-env-setup.md 指出具体的安装说明应回到主 SKILL.md 按 Agent 环境选择对应文档。仓库在references/setup/目录下为每种主流 Agent 提供了分步指引下面按 Agent 分类汇总。Gemini CLI推荐通过扩展安装参考 references/setup/gemini_cli.md推荐方式是通过 Gemini 扩展一次性安装 Skill 与 MCP Server。先检查是否已安装gemini extensions list若输出包含firebase则已安装未安装则执行gemini extensions install https://github.com/firebase/agent-skills验证安装gemini mcp list应包含firebase-toolsgemini skills list应包含firebase-basic发生任何新安装后重启 Gemini CLI 并等待用户确认。若只想在当前项目范围内使用 MCP也可以手动配置项目级作用域gemini mcp add -e IS_GEMINI_CLI_EXTENSIONtrue firebase npx -y firebase-toolslatest mcp随后用gemini mcp list确认firebase-tools已连接并重启 Gemini CLI。Claude Code推荐通过插件市场安装参考 references/setup/claude_code.md推荐使用插件市场同时安装 Skills 与 MCP 功能。检查现状npx skills list --agent claude-code本地与npx skills list --global --agent claude-code全局是否包含firebase-basics再运行claude mcp list -s user与claude mcp list -s project检查 MCP 中是否包含firebase判定安装路径若 Skills 与 MCP 都已存在则完全安装、停止若只存在其一混合状态应先停下与用户确认是否继续安装插件添加市场默认 User 作用域claude plugin marketplace add firebase/agent-skills安装插件claude plugin install firebasefirebase重新执行步骤 1 的检查确认 Skills 与 MCP 均可用然后重启 Claude Code。Android Studio仅安装 Skills跳过 MCP参考 references/setup/android_studio.mdAndroid Studio 中的 Gemini 期望 Skills 位于~/.agents/skills安装命令为npx -y skills add firebase/agent-skills --skill * --yesMCP 部分在 Android Studio 中当前被跳过Android Studio 仅支持 SSE 传输而 Firebase CLI MCP Server 使用 stdio 传输没有 SSE-to-stdio 代理则无法直接集成。这是一个值得注意的平台限制Android 开发者在 Android Studio 中应以 CLI 命令方式操作 Firebase。AntigravitySkills 手动配置 MCP参考 references/setup/antigravity.md检查本地 Skillsls -d .agent/skills/firebase-basics或ls -d .agents/skills/firebase-basics检查全局 Skillsnpx skills list --global --agent antigravity未安装则执行npx skills add firebase/agent-skills --agent antigravity --skill *MCP 配置被视为完整功能的必需扩展配置配置文件位于 macOS/Linux 的~/.gemini/antigravity/mcp_config.json或 Windows 的%USERPROFILE%\.gemini\antigravity\mcp_config.json。若文件不存在先创建并初始化为{ mcpServers: {} }然后向mcpServers对象中合并以下块必须保留其中已有的其他服务器条目firebase: { command: npx, args: [-y, firebase-toolslatest, mcp] }保存文件、确认 JSON 格式正确重启 Antigravity 后在 UI 的 MCP 服务器列表中确认 Firebase MCP Server 已连接。CursorSkills 手动配置 MCP参考 references/setup/cursor.md流程与 Antigravity 类似检查 Skillsnpx skills list --agent cursor本地与npx skills list --global --agent cursor全局未安装则执行npx skills add firebase/agent-skills --agent cursor --skill *MCP 配置全局文件~/.cursor/mcp.json或项目文件.cursor/mcp.json缺失时初始化为{ mcpServers: {} }再合并 firebase 块firebase: { command: npx, args: [-y, firebase-toolslatest, mcp] }保存后重启 Cursor并在 UI 中确认 MCP 连接。GitHub Copilot全局安装 Skills 配置mcp.json参考 references/setup/github_copilot.mdSkills 建议全局安装跨项目一致访问npx skills add firebase/agent-skills --agent github-copilot --skill *MCP 配置文件位于工作区.vscode/mcp.json或全局用户设置mcp.json缺失时初始化为{ mcp: { servers: {} } }注意 GitHub Copilot 的配置结构是mcp.servers且需要type: stdio字段firebase: { type: stdio, command: npx, args: [-y, firebase-toolslatest, mcp] }保存后重启 VS Code并在 Copilot 的 MCP 服务器列表中确认连接。其他 AgentWindsurf、Cline、Claude Desktop 等参考 references/setup/other_agents.md以agent-name占位符替换为实际 Agent 名称Agent 名称可在 skills CLI 项目文档中查到npx skills list --agent agent-name npx skills list --global --agent agent-name npx skills add firebase/agent-skills --agent agent-name --skill *MCP 配置文件因 Agent 而异例如~/.codeium/windsurf/mcp_config.json、cline_mcp_settings.json、claude_desktop_config.json统一在mcpServers对象中合并 firebase 块firebase: { command: npx, args: [-y, firebase-toolslatest, mcp] }注意所有手动配置都有一条 CRITICAL 约束合并时务必保留mcpServers或mcp.servers中已存在的其他服务器条目防止覆盖用户原有配置。MCP 配置的通用判定标准在多数 Agent 的配置文档中判断firebase条目是否有效遵循同一标准command为firebase或command为npx且args中包含firebase-tools与mcp。两种形态都合法firebase: { command: npx, args: [-y, firebase-toolslatest, mcp] }firebase: { command: firebase, args: [mcp] }若发现合法条目即可跳过新增步骤若缺失或错误则按上文补齐。环境就绪后的下一步项目上下文与配置获取完成上述四步后Agent 便具备了操作 Firebase 的完整能力。在 SKILL.md 的后续流程中紧接着的环境初始化内容还包括激活项目npx -y firebase-toolslatest use查看当前项目npx -y firebase-toolslatest use PROJECT_ID切换项目创建新项目使用npx -y firebase-toolslatest projects:create project-id --display-name display-nameproject-id 需 6–30 个字符、小写、可含数字与连字符且全局唯一。自动化获取应用配置文件不要在控制台手动下载而是用 CLI 获取——Android 使用npx -y firebase-toolslatest apps:sdkconfig ANDROID APP_ID --project PROJECT_IDiOS 使用npx -y firebase-toolslatest apps:sdkconfig IOS APP_ID --project PROJECT_ID输出保存到app/google-services.jsonAndroid或供 Xcode 工程关联的路径iOS。初始化新服务需要新建 Firebase 服务时可参考 references/firebase-service-init.mdSDK 接入分别参考 web_setup.md、android_setup.md、ios_setup.md。常见问题速查现象处理方式node --version无输出或版本 20按第一步安装 Node.js推荐 nvm安装后重新 source profile 并再次验证npx -y firebase-toolslatest --version失败回到 Node.js 环境与网络npm 仓库可达性排查登录时浏览器无法自动打开改用npx -y firebase-toolslatest login --no-localhost远程/无浏览器环境无法登录同上使用--no-localhost配合授权码方式Agent 无法识别 firebase 命令检查 Skills 是否安装npx skills list且已重启 AgentMCP Server 未连接检查对应 Agent 的mcp.json/mcp_config.json中 firebase 块是否合法重启 Agent 后在 UI 确认Android Studio 中无法集成 MCP平台仅支持 SSE 传输而 Firebase MCP 为 stdio当前设计为跳过 MCP改用 CLI总结一份可执行的初始化检查清单将 local-env-setup.md 的完整要求归纳为如下清单Agent 与开发者都可逐项勾选node --version输出 20不满足则按操作系统用 nvm 或官方安装器安装并等待用户确认npx -y firebase-toolslatest --version成功输出版本字符串npx -y firebase-toolslatest login或--no-localhost完成认证按所在 Agent 环境完成 Skills 与 Firebase MCP Server 的安装与验证重启 Agent 确认连接全部完成后才可开始项目创建/切换、配置获取等后续 Firebase 操作。本文所有命令与配置均以当前仓库 firebase-basics 及其references/目录下的文档为准可作为 Agent 自动化环境初始化的直接参考。【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考