Serwer MCP Firebase

Serwer Firebase MCP to lokalny serwer Model Context Protocol (MCP), który działa w środowisku programistycznym, aby umożliwić narzędziom dla programistów opartym na AI pracę z projektami w Firebase i bazą kodu aplikacji.

Serwer Firebase MCP współpracuje z każdym narzędziem, które może pełnić rolę klienta MCP, w tym z: Antigravity, Claude Code i Claude Desktop, Cline, Cursor, VS Code Copilot, Windsurf i innymi.

arrow_downward Przejdź do instrukcji konfiguracji

Korzyści z serwera MCP

Edytor skonfigurowany do korzystania z serwera MCP Firebase może używać funkcji AI, aby:

• Tworzenie projektów Firebase i zarządzanie nimi
• Zarządzanie użytkownikami Firebase Authentication
• Praca z danymi w Cloud Firestore i Firebase SQL Connect
• Pobieranie schematów Firebase SQL Connect
• Omówienie reguł zabezpieczeń dla Cloud Firestore i Cloud Storage for Firebase
• Wysyłanie wiadomości z imieniem Firebase Cloud Messaging

To tylko częściowe listy. Pełną listę narzędzi dostępnych dla edytora znajdziesz w sekcji Możliwości serwera.

Konfigurowanie klienta MCP

Serwer MCP Firebase to lokalny serwer MCP, który może współpracować z dowolnym klientem MCP obsługującym standardowe wejście/wyjście (stdio) jako medium transportowe.

Gdy serwer MCP Firebase wykonuje wywołania narzędzi, działa lokalnie w Twoim środowisku, używając tych samych danych logowania użytkownika, które autoryzują interfejs Firebase CLI. Może to być zalogowany użytkownik lub domyślne dane logowania aplikacji w zależności od środowiska.

Zanim zaczniesz

Sprawdź, czy masz działającą instalację Node.js i npm.

Podstawowa konfiguracja

Oto podstawowe instrukcje konfiguracji serwera MCP Firebase do używania z niektórymi popularnymi narzędziami wspomaganymi przez AI:

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

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

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

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

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

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

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

Konfiguracja opcjonalna

Oprócz podstawowej konfiguracji każdego klienta, która została pokazana wcześniej, możesz określić 2 parametry opcjonalne:

• --dir ABSOLUTE_DIR_PATH: ścieżka bezwzględna do katalogu zawierającego firebase.json, aby ustawić kontekst projektu dla serwera MCP. Jeśli nie określono inaczej, narzędzia get_project_directory i set_project_directory staną się dostępne, a domyślnym katalogiem będzie katalog roboczy, w którym uruchomiono serwer MCP.

• --only FEATURE_1,FEATURE_2: lista rozdzielona przecinkami grup funkcji do aktywowania. Użyj tej opcji, aby ograniczyć liczbę narzędzi do tych funkcji, z których aktywnie korzystasz. Pamiętaj, że podstawowe narzędzia są zawsze dostępne.

Przykład:

"firebase": {
  "command": "npx",
  "args": [
    "-y",
    "firebase-tools@latest", "mcp",
    "--dir", "/Users/turing/my-project",
    "--only", "auth,firestore,storage"
  ]
}

Możliwości serwera MCP

Serwer Firebase MCP udostępnia 3 różne kategorie funkcji MCP:

• Prompty: biblioteka gotowych promptów, które możesz uruchomić. Są one zoptymalizowane pod kątem tworzenia i uruchamiania aplikacji za pomocą Firebase.

• Narzędzia: zestaw narzędzi przeznaczonych do użytku przez agentów AI, które pomagają im bezpośrednio pracować nad Twoim projektem w Firebase (za Twoją zgodą).

• Zasoby: pliki dokumentacji przeznaczone do użytku przez agentów AI, aby zapewnić im więcej wskazówek i kontekstu do wykonania zadania lub osiągnięcia celu.

Prompty

Serwer MCP Firebase zawiera bibliotekę gotowych promptów zoptymalizowanych pod kątem tworzenia i uruchamiania aplikacji w Firebase. Możesz używać tych promptów do wykonywania różnych typowych zadań lub osiągania celów za pomocą asystentów AI.

W tabeli poniżej opisano prompty udostępniane przez serwer MCP.

Wiele narzędzi deweloperskich obsługujących MCP zapewnia wygodny sposób uruchamiania tych promptów. Na przykład jako polecenie po ukośniku:

/firebase:init

W obsługiwanych środowiskach możesz zacząć pisać /firebase:, aby wyświetlić listę dostępnych promptów.

npx firebase-tools@latest mcp --generate-prompt-list

Narzędzia

Serwer MCP Firebase udostępnia też szereg narzędzi przeznaczonych do użytku przez agentów AI, które pomagają im bezpośrednio pracować z Twoim projektem w Firebase (za Twoją zgodą!). W przeciwieństwie do promptów nie wywołujesz tych narzędzi bezpośrednio. Zamiast tego agenci AI obsługujący wywoływanie narzędzi (np. Antigravity, Claude Code lub Cursor) mogą automatycznie wywoływać te narzędzia w razie potrzeby, aby wykonywać zadania związane z programowaniem.

W tabeli poniżej opisano narzędzia udostępniane przez serwer MCP.

npx firebase-tools@latest mcp --generate-tool-list

{
  "parent": "projects/my-project/databases/(default)/documents",
  "structured_aggregation_query": {
    "structured_query": {
      "from": [{"collection_id": "orders"}],
      "where": {
        "field_filter": {
          "field": {"field_path": "status"},
          "op": "EQUAL",
          "value": {"string_value": "COMPLETED"}
        }
      }
    },
    "aggregations": [
      {
        "alias": "total_orders",
        "count": {}
      },
      {
        "alias": "average_amount",
        "avg": {
          "field": {"field_path": "amount"}
        }
      }
    ]
  }
}

Zasoby

Serwer MCP udostępnia zasoby, czyli pliki dokumentacji przeznaczone do użytku przez agentów AI. Agenci, którzy obsługują korzystanie z zasobów, automatycznie uwzględniają odpowiednie zasoby w kontekście sesji.

W tabeli poniżej opisano zasoby udostępniane przez serwer MCP.

npx firebase-tools@latest mcp --generate-resource-list