Serwer MCP Firebase

Serwer MCP Firebase 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 działa z każdym narzędziem, które może działać jako klient MCP, w tym z: Antigravity, Claude Code i Claude Desktop, Cline, Cursor, VS Code Copilot, Windsurf i innymi.

arrow_downward Przejdź do instrukcji konfiguracji

Zalety serwera MCP

Edytor skonfigurowany do korzystania z serwera Firebase MCP może używać jego funkcji AI, aby pomóc Ci:

• Tworzenie projektów 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ń w Cloud Firestore i Cloud Storage for Firebase
• Wysyłanie wiadomości za pomocą Firebase Cloud Messaging

To tylko częściowe listy. Pełną listę narzędzi dostępnych w edytorze 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 wywołuje narzędzia, działa lokalnie w Twoim środowisku, używając tych samych danych logowania użytkownika, które autoryzują interfejs wiersza poleceń Firebase. W zależności od środowiska może to być zalogowany użytkownik lub domyślne uwierzytelnianie aplikacji.

Zanim zaczniesz

Upewnij się, że masz działającą instalację Node.js i npm.

Podstawowa konfiguracja

Oto podstawowe instrukcje konfiguracji serwera MCP Firebase 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, pokazanej wcześniej, możesz określić 2 opcjonalne parametry:

• --dir ABSOLUTE_DIR_PATH: ścieżka bezwzględna do katalogu zawierającego firebase.json, aby ustawić kontekst projektu dla serwera MCP. Jeśli nie zostanie określony, dostępne będą narzędzia get_project_directory i set_project_directory, 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 aktywacji. Użyj tej opcji, aby ograniczyć wyświetlane narzędzia tylko do funkcji, których aktywnie używasz. 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 uruchamiać. 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 pracować bezpośrednio z projektem w Firebase (za Twoją zgodą).

• Zasoby: pliki dokumentacji przeznaczone do użytku przez agentów AI, które zawierają więcej wskazówek i kontekstu, aby pomóc im w wykonaniu zadania lub osiągnięciu celu.

Prompty

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

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

Wiele narzędzi dla programistów 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ąć wpisywać /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 pracować bezpośrednio z projektem w Firebase (za Twoją zgodą). W przeciwieństwie do promptów nie wywołujesz tych narzędzi bezpośrednio. Agenty AI, które obsługują wywoływanie narzędzi (takie jak Antigravity, Claude Code czy Cursor), mogą automatycznie wywoływać te narzędzia, aby w razie potrzeby wykonywać zadania programistyczne.

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. Agenty, które obsługują korzystanie z zasobów, będą automatycznie uwzględniać 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