企业官网建设流程全解析

在 Android Studio 中配置 Firebase Agent Skills：Gemini 本地集成与 MCP 限制实战指南

【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills

Android Studio 内置的 Gemini 助手可以借助 Agent Skills 获得 Firebase 的上下文感知能力，从而在开发 Android 应用时自动完成 Firebase CLI 登录、项目创建、配置文件拉取等基础操作。本篇指南以本项目仓库中的 Android Studio 环境配置文档 为核心骨架，完整讲解 Skills 的安装、校验与更新流程，并深入剖析其 MCP（Model Context Protocol）集成限制——Android Studio 仅支持 SSE 传输而 Firebase CLI MCP 服务器使用 stdio，因此官方并不提供直接集成方案。读完本文，你将能在 Android Studio 环境中独立完成 Firebase Agent Skills 的部署，并理解其与 Antigravity、Gemini CLI 等环境在 MCP 配置上的本质差异。

一、背景：为什么需要在 Android Studio 中配置 Firebase Skills

firebase-basics 是本仓库中 Firebase 技术技能套件的基础技能，其职责聚焦于 Firebase CLI 的安装与登录（firebase-tools@latest、login、login --no-localhost）、项目创建与切换（firebase use、projects:create），以及应用配置文件（google-services.json、GoogleService-Info.plist）的拉取，不覆盖 Hosting 部署、Firestore、Auth 等高级服务。

在 Android Studio 中，这些能力通过 Gemini 助手以 Agent Skills 的形式注入。官方对 Android Studio 的集成预期是：Gemini 从~/.agents/skills目录加载已安装的技能包。因此，配置工作本质上是两件事：

1. 将 Firebase Skills 安装（或软链接）到~/.agents/skills；
2. 明确 MCP 服务器在 Android Studio 中当前不可直接配置，并选择合理的替代路径。

这一集成路径在整个技能套件的环境配置体系中与其他编辑器并列。本仓库 SKILL.md 的前置检查章节 明确指出，在配置任何扩展或 Agent 环境之前，必须先阅读 本地环境设置文档，并按其列出的环境（Gemini CLI、Antigravity、Android Studio、Claude Code、Cursor、GitHub Copilot、Other Agents）分别执行对应安装说明。

二、安装前置条件：本地环境基线

在向~/.agents/skills写入任何技能之前，本地环境设置文档 要求逐一验证以下三项基线，缺一不可：

这里有一个贯穿整个技能套件的核心原则：所有 CLI 调用都必须以npx -y firebase-tools@latest前缀执行，而不是裸的firebase命令。这在 SKILL.md 的 Firebase 使用原则 中有明确规定，目的是确保始终使用最新版本的 Firebase CLI。Node.js 版本门槛（>= 20）则是 Firebase CLI 及skills安装器正常运行的最低保障。

三、核心步骤：将 Firebase Skills 安装到~/.agents/skills

Android Studio 环境配置文档 给出的安装命令只有一条，但它蕴含了三个关键信息：

npx -y skills add firebase/agent-skills --skill "*" --yes

逐参数拆解如下：

• npx -y skills：通过 npx 直接运行skillsCLI（技能安装器），无需全局安装，-y自动确认包下载；
• add firebase/agent-skills：从firebase/agent-skills仓库拉取技能列表；
• --skill "*"：安装通配符匹配下的全部Firebase 技能（包括firebase-basics在内的整套技能）；
• --yes：跳过交互式确认，适合无人值守的自动化环境。

安装完成后，必须确认技能已安装或软链接到~/.agents/skills目录。这是 Gemini in Android Studio 扫描技能的唯一约定路径，路径错误会导致 Gemini 无法发现任何 Firebase 技能。验证命令如下：

ls -la ~/.agents/skills

预期输出中应能看到firebase-basics（以及同批安装的其他 Firebase 技能）对应的目录项。

四、技能维护：增量安装、检查与更新

技能安装不是一次性工作。Firebase 最佳实践演进迅速，SKILL.md 的更新原则 要求定期检查并更新 Agent Skills，且针对 Android Studio 给出了专门的更新指引——即 刷新 Android Studio 本地环境文档。该文档提供了完整的维护四步法：

1. 列出仓库中可用的全部 Firebase 技能：

npx -y skills add firebase/agent-skills --list

2. 检查当前已安装的技能：

ls -la ~/.agents/skills

对比第 1 步的列表与第 2 步的实际内容，即可定位缺失的技能。

3. 增量添加缺失技能：如果skillsCLI 支持android_studio这一 agent 标识符，可运行：

npx -y skills add firebase/agent-skills --agent android_studio --skill "*" --yes

若 CLI 不支持 Android Studio 标识符，则退化为手动方案：将本地克隆的firebase/agent-skills中所需技能目录直接复制或软链接到~/.agents/skills。

4. 更新既有技能：

npx -y skills update --agent android_studio --yes

若此前是手动安装，则应拉取firebase/agent-skills仓库的最新改动，再把更新后的文件同步到~/.agents/skills。

五、MCP 配置：为什么 Android Studio 被跳过

这是 Android Studio 环境配置文档 中最关键、也最容易被误解的部分：MCP 设置在 Android Studio 中当前被明确跳过，原因是传输协议不匹配：

• Android Studio 的 MCP 客户端只支持 SSE（Server-Sent Events）传输；
• Firebase CLI 的 MCP 服务器（npx -y firebase-tools@latest mcp）使用 stdio（标准输入输出）传输；
• 在没有 SSE-to-stdio 代理的情况下，二者无法直接握手，因此官方不提供直接集成。

换句话说，Firebase MCP 服务器是为子进程式启动、通过标准输入输出与宿主进程通信的场景设计的；而 Android Studio 作为 IDE 内嵌的 Gemini 环境，其 MCP 通道走 HTTP 长连接（SSE），两者协议栈不同，无法原生互通。

5.1 对比：其他 Agent 环境如何配置 Firebase MCP

理解了 Android Studio 的限制后，通过横向对比更能看清协议差异的本质。在本仓库中：

• Antigravity：其配置指引（antigravity.md）要求修改~/.gemini/antigravity/mcp_config.json，在mcpServers中写入如下配置并保留其他既有服务器条目：

  "firebase": { "command": "npx", "args": ["-y", "firebase-tools@latest", "mcp"] }

  或以全局安装的 CLI 形式配置："command": "firebase", "args": ["mcp"]。

• Gemini CLI：其扩展安装方式（gemini_cli.md）通过gemini extensions install一次获得 Skills 与 MCP，也可用gemini mcp add -e IS_GEMINI_CLI_EXTENSION=true firebase npx -y firebase-tools@latest mcp进行项目级手工配置。

这两类环境的共同点是 MCP 服务器都作为本地子进程启动（stdio 传输），因此 Firebase MCP 可以正常工作；而 Android Studio 的 SSE-only 通道正是被跳过的直接原因。从仓库文档的表述可以推断，未来若存在 SSE-to-stdio 代理或 Android Studio 支持 stdio 传输，MCP 配置才有可能被纳入其官方指引。

5.2 无 MCP 时的替代路径

MCP 缺失并不等于 Firebase 能力缺失。Android Studio 中的 Gemini 依然可以：

1. 借助已安装的 Skills 获取 Firebase 的操作流程上下文（如项目创建、应用注册、配置文件拉取的最佳实践与安全检查点）；
2. 通过 Skills 内约定的npx -y firebase-tools@latest ...命令，在 IDE 终端中直接执行 Firebase CLI 操作；
3. 在需要远程 Firebase API 交互（如 Crashlytics 日志、Data Connect 查询）时，回到支持 stdio 的 Agent 环境（如 Gemini CLI、Antigravity）中配合 MCP 完成。

六、安装后的实战衔接：从项目创建到google-services.json

完成 Skills 安装后，Android Studio 的 Gemini 即可按 firebase-basics 定义的工作流，在 Android 应用开发中执行以下端到端操作（完整命令可见 Firebase Android 设置指南）：

1. 创建 Firebase 项目（若尚无）：

npx -y firebase-tools@latest projects:create <UNIQUE_PROJECT_ID> --display-name '<DISPLAY_NAME>'

项目 ID 须为 6–30 字符、全小写，可包含数字与连字符，且全局唯一。

2. 注册 Android 应用（display name 作为位置参数置于末尾）：

npx -y firebase-tools@latest apps:create ANDROID '<APP_DISPLAY_NAME>' --package-name '<PACKAGE_NAME>' --project <PROJECT_ID>

3. 拉取google-services.json（使用上一步输出中的 App ID）：

npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>

输出需保存为app/google-services.json。这里特别强调：不要引导用户从 Firebase 控制台手动下载配置文件，SKILL.md 的使用原则 明确要求以 CLI 程序化获取，保证流程可复现。

4. 验证：

npx -y firebase-tools@latest projects:list npx -y firebase-tools@latest apps:list --project <PROJECT_ID>

七、常见问题与注意事项

八、小结

Android Studio 中的 Firebase Agent Skills 配置以~/.agents/skills为唯一落点，一条npx -y skills add firebase/agent-skills --skill "*" --yes命令即可完成安装，配合--list/--agent android_studio/update可完成增量维护与更新。与此同时，MCP 的缺失是由 SSE 与 stdio 的协议差异决定的设计约束而非遗漏，理解了这一点，就能在不同 Agent 环境之间做出正确的选型：Skills 保证"知道怎么用 Firebase"，MCP 保证"能直接调用 Firebase 远程 API"，二者按需组合、互为补充。

关联文档索引：

• Android Studio 环境配置（本文主体文档）
• firebase-basics 技能主文档
• 本地环境设置（前置检查）
• Android Studio 技能刷新指南
• Firebase Android 设置指南（实战命令）
• Antigravity 环境配置（MCP 对比参照）
• Gemini CLI 环境配置（MCP 对比参照）

【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills