mcpField
F
firebase-basics

firebase-basics

官方
github.com/firebase数据与数据库491177.1k 次安装1 天前更新
代码仓库

关于 firebase-basics

firebase-basics 是面向使用 Firebase 的编码 Agent 的技能，提供环境、身份验证和项目配置流程，并引导使用官方知识与 Firebase CLI、MCP 服务及相关技能。

主要功能

  1. 01检查 Firebase CLI 与 MCP 服务
  2. 02配置登录和活动项目
  3. 03通过 CLI 获取移动端配置
  4. 04查阅服务初始化与 SDK 指南

适用场景

  1. 01为应用初始化 Firebase 服务
  2. 02设置 Web、Android 或 iOS SDK
  3. 03查询 Firebase 用法并操作远程 API

MCP 相关

指导 Agent 优先使用 Firebase MCP 服务的工具来访问远程 Firebase API，并要求先确认 Firebase MCP 服务是否已安装。

#databases

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/firebase/agent-skills --skill firebase-basics

安装后在 Claude Code 中输入/firebase-basics确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
android_setup.md
firebase-cli-guide.md
firebase-service-init.md
flutter_setup.md
ios_setup.md
local-env-setup.md
web_setup.md
references/refresh/
android_studio.md
antigravity.md
claude.md
gemini-cli.md
other-agents.md
references/setup/
android_studio.md
antigravity.md
claude_code.md
cursor.md
gemini_cli.md
github_copilot.md
other_agents.md

详细介绍

前置条件

继续之前，请完成以下设置步骤：

  1. 本地环境设置： 确认环境已正确设置，以便我们使用 Firebase 工具：

  2. 身份验证： 确保已登录 Firebase，以便命令拥有正确的权限。先运行 npx -y firebase-tools@latest login:list；如果尚未登录，请运行 npx -y firebase-tools@latest login。对于无法使用浏览器的环境（例如远程 shell），请使用 npx -y firebase-tools@latest login --no-localhost。

    • 命令应输出当前用户。
    • 如果尚未登录，请按照此命令的交互式说明完成身份验证。

  3. 活动项目： 大多数 Firebase 任务都需要指定活动项目。

    重要

    对于 Agent： 如果未提供项目 ID，必须暂停并询问开发者希望：

    1. 提供现有 Firebase 项目 ID，还是
    2. 创建新的 Firebase 项目。

    • 如果使用现有项目 ID：

      1. 使用 npx -y firebase-tools@latest use 检查当前项目（如果项目根目录下缺少 firebase.json，请先创建 {}）。

      2. 如果命令输出 Active Project: <project-id>，请向用户确认这是否是预期项目。

      3. 如果不是，或者没有活动项目，请设置用户提供的项目：

        npx -y firebase-tools@latest use <PROJECT_ID>

    • 如果要创建新项目： 运行以下命令创建项目：

      npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"

      注意：<project-id> 必须为 6-30 个字符，全部使用小写字母，且可以包含数字和连字符。它必须在全球范围内唯一。

Firebase 使用原则

请遵循以下原则：

  1. CLI 命令使用 npx： 为确保始终使用最新版本的 Firebase CLI，请始终在命令前加上 npx -y firebase-tools@latest，而不要只使用 firebase。例如，使用 npx -y firebase-tools@latest --version。绝不要建议使用裸 firebase 命令作为替代方案。
  2. 优先查阅官方知识： 对于任何与 Firebase 相关的知识，请先使用 developerknowledge_search_documents MCP 工具进行查询，再考虑使用 Google Search 或内部知识库。在搜索查询中加入“Firebase”能显著提高相关性。
  3. 遵循 Agent Skills 提供的实现指导： Skills 提供带有明确主张的工作流（CUJ）、安全规则和最佳实践。请务必查阅这些内容，了解如何正确实现 Firebase 功能，而不要依赖通用知识。
  4. 使用 Firebase MCP Server 工具，而非直接调用 API： 每当需要与远程 Firebase API 交互时（例如获取 Crashlytics 日志或执行 Data Connect 查询），请使用 Firebase MCP Server 提供的工具，而不要尝试手动调用 API。
  5. 及时更新插件 / Agent Skills： Firebase 最佳实践发展迅速，请定期检查并安装 Firebase 插件或 Agent Skills 的更新。同样，如果遇到工具或命令过时的问题，请根据 Agent 环境按照以下步骤操作：
  6. 自动获取配置文件： 设置 iOS 或 Android 应用时，切勿让用户前往 Firebase Console 下载 google-services.json 或 GoogleService-Info.plist。请改用 Firebase CLI 以编程方式获取配置：
    • 对于 Android： npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
    • 对于 iOS： npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID> 将输出保存到相应位置（例如，Android 使用 app/google-services.json，iOS 使用 xcode-project-setup 要关联的路径）。

参考资料

常见问题

  • 登录问题： 如果登录步骤中浏览器无法打开，请改用 npx -y firebase-tools@latest login --no-localhost。

  • Genkit： 如果使用 Genkit，请安装 skills：

    npx skills add genkit-ai/skills

评论

支持 Markdown