mcpField
F
firebase-basics

firebase-basics

公式
github.com/firebaseデータ・データベース491177.1k 回インストール1 日前に更新
リポジトリ

firebase-basics について

firebase-basics は、Firebase を扱うコーディングエージェント向けのスキルです。環境、認証、プロジェクト設定を案内し、公式ナレッジや Firebase CLI、MCP ツール、関連スキルの利用を促します。

主な機能

  1. 01Firebase CLI と MCP サーバーの確認
  2. 02認証とアクティブプロジェクトの設定
  3. 03CLI によるモバイルアプリ設定の取得
  4. 04サービス初期化と SDK ガイドの参照

活用シーン

  1. 01アプリ向け Firebase サービスの初期化
  2. 02Web、Android、iOS SDK の設定
  3. 03Firebase の情報検索とリモート API 操作

MCP 対応

リモート Firebase API の操作には Firebase MCP サーバーのツールを優先し、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 を実行します。ブラウザーを利用できない環境（リモートシェルなど）では、npx -y firebase-tools@latest login --no-localhost を使用します。

    • このコマンドを実行すると、現在のユーザーが出力されます。
    • ログインしていない場合は、このコマンドの対話形式の手順に従って認証します。

  3. アクティブなプロジェクト： Firebase のタスクのほとんどでは、アクティブなプロジェクトのコンテキストが必要です。

    重要

    エージェント向け： プロジェクト ID が指定されていない場合は、必ず一時停止して、既存の Firebase プロジェクト ID を使用するか、新しい Firebase プロジェクトを作成するか、開発者に確認してください。

    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 を使用できるよう、コマンドには firebase ではなく、必ず npx -y firebase-tools@latest を先頭に付けてください。たとえば、npx -y firebase-tools@latest --version を使用します。代替手段として、firebase コマンドをそのまま使用する方法を提案してはいけません。
  2. 公式の知識を優先する： Firebase 関連の知識については、Google 検索や内部のナレッジベースに頼る前に、developerknowledge_search_documents MCP ツールを参照してください。検索クエリに「Firebase」を含めると、関連性が大幅に高まります。
  3. 実装ガイダンスには Agent Skills に従う： Skills には、方針が明確なワークフロー（CUJ）、セキュリティルール、ベストプラクティスが用意されています。一般的な知識に頼るのではなく、Firebase の機能を正しく実装する方法を理解するため、必ず参照してください。
  4. 直接 API を呼び出す代わりに Firebase MCP Server のツールを使用する： Crashlytics のログ取得や Data Connect クエリの実行など、リモート Firebase API とやり取りする必要がある場合は、手動で API を呼び出そうとせず、Firebase MCP Server が提供するツールを使用してください。
  5. プラグイン／Agent Skills を最新の状態に保つ： Firebase のベストプラクティスは急速に変化するため、Firebase プラグインまたは Agent Skills の更新を定期的に確認し、インストールしてください。同様に、古いツールやコマンドに関する問題が発生した場合は、エージェント環境に応じて以下の手順に従ってください。
  6. 設定ファイルの取得を自動化する： iOS または Android アプリを設定する際、google-services.json や GoogleService-Info.plist をダウンロードするために、Firebase Console へアクセスするようユーザーに案内してはいけません。代わりに、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 を使用する場合は、スキルをインストールしてください。

    npx skills add genkit-ai/skills

コメント

Markdown 対応