Server MCP di Firebase

Il server Firebase MCP è un server Model Context Protocol (MCP) locale che viene eseguito nel tuo ambiente di sviluppo per consentire agli strumenti per sviluppatori basati sull'AI di interagire con i tuoi progetti Firebase e con il codebase della tua app.

Il server MCP di Firebase funziona con qualsiasi strumento che può fungere da client MCP, tra cui: Antigravity, Claude Code e Claude Desktop, Cline, Cursor, VS Code Copilot, Windsurf e altri ancora.

arrow_downward Vai alle istruzioni di configurazione

Vantaggi del server MCP

Un editor configurato per utilizzare il server MCP di Firebase può utilizzare le sue funzionalità di AI per aiutarti a:

• Crea e gestisci progetti Firebase
• Gestisci gli utenti di Firebase Authentication
• Utilizza i dati in Cloud Firestore e Firebase SQL Connect
• Recupera gli schemi Firebase SQL Connect
• Comprendi le regole di sicurezza per Cloud Firestore e Cloud Storage for Firebase
• Invia messaggi con Firebase Cloud Messaging

Questi sono solo elenchi parziali. Consulta la sezione Funzionalità del server per un elenco completo degli strumenti disponibili per l'editor.

Configura il client MCP

Il server MCP di Firebase è un server MCP locale che può funzionare con qualsiasi client MCP che supporti l'I/O standard (stdio) come mezzo di trasporto.

Quando il server Firebase MCP effettua chiamate agli strumenti, viene eseguito localmente nel tuo ambiente utilizzando le stesse credenziali utente che autorizzano l'interfaccia a riga di comando Firebase. Potrebbe trattarsi di un utente che ha eseguito l'accesso o di Credenziali predefinite dell'applicazione, a seconda dell'ambiente.

Prima di iniziare

Assicurati di avere un'installazione funzionante di Node.js e npm.

Configurazione di base

Ecco le istruzioni di configurazione di base per l'utilizzo del server MCP di Firebase con alcuni strumenti di assistenza AI più diffusi:

{
  "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"]
  }
}

Configurazione facoltativa

Oltre alla configurazione di base per ogni client, mostrata in precedenza, puoi specificare due parametri facoltativi:

• --dir ABSOLUTE_DIR_PATH: il percorso assoluto di una directory contenente firebase.json, per impostare un contesto di progetto per il server MCP. Se non specificato, diventano disponibili gli strumenti get_project_directory e set_project_directory e la directory predefinita sarà la directory di lavoro in cui è stato avviato il server MCP.

• --only FEATURE_1,FEATURE_2: un elenco separato da virgole dei gruppi di funzionalità da attivare. Utilizza questa opzione per limitare gli strumenti esposti solo alle funzionalità che utilizzi attivamente. Tieni presente che gli strumenti principali sono sempre disponibili.

Ad esempio:

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

Funzionalità del server MCP

Il server MCP di Firebase fornisce tre diverse categorie di funzionalità MCP:

• Prompt: una libreria di prompt predefiniti che puoi eseguire; sono ottimizzati per lo sviluppo e l'esecuzione di un'app con Firebase

• Strumenti: un insieme di strumenti destinati all'utilizzo da parte degli agenti AI che li aiutano a lavorare direttamente con il tuo progetto Firebase (con la tua approvazione).

• Risorse: file di documentazione destinati all'utilizzo da parte degli agenti AI per fornire loro maggiori indicazioni e contesto per completare un'attività o un obiettivo

Prompt

Il server Firebase MCP include una libreria di prompt predefiniti ottimizzati per lo sviluppo e l'esecuzione di un'app con Firebase. Puoi utilizzare questi prompt per completare varie attività o obiettivi comuni con i tuoi assistenti AI agentici.

La tabella seguente descrive i prompt resi disponibili dal server MCP.

Molti strumenti per sviluppatori che supportano l'MCP forniscono un modo pratico per eseguire questi prompt. Ad esempio, come comando slash:

/firebase:init

Negli ambienti supportati, puoi iniziare a digitare /firebase: per visualizzare un elenco di prompt disponibili.

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

Strumenti

Il server MCP di Firebase fornisce anche una serie di strumenti destinati all'utilizzo da parte degli agenti AI che li aiutano a lavorare direttamente con il tuo progetto Firebase (con la tua approvazione). A differenza dei prompt, non chiami direttamente questi strumenti; piuttosto, gli agenti AI che supportano la chiamata degli strumenti (come Antigravity, Claude Code o Cursor) possono chiamarli automaticamente per eseguire attività di sviluppo quando necessario.

La tabella seguente descrive gli strumenti messi a disposizione dal server 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"}
        }
      }
    ]
  }
}

Risorse

Il server MCP fornisce risorse, ovvero file di documentazione destinati all'utilizzo da parte degli agenti AI. Gli agenti che supportano l'utilizzo delle risorse includeranno automaticamente le risorse pertinenti nel contesto della sessione.

La tabella seguente descrive le risorse messe a disposizione dal server MCP.

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