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 di sviluppo basati sull'AI di funzionare con i tuoi progetti Firebase e il codebase della tua app.

Il server MCP Firebase funziona con qualsiasi strumento che possa 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 Firebase MCP può utilizzare le sue funzionalità di AI per aiutarti a:

• Creare e gestire progetti Firebase
• Gestire gli utenti di Firebase Authentication
• Utilizzare i dati in Cloud Firestore e Firebase SQL Connect
• Recupera schemi Firebase SQL Connect
• Comprendere le regole di sicurezza per Cloud Firestore e Cloud Storage for Firebase
• Inviare 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 Firebase MCP è un server MCP locale che può funzionare con qualsiasi client MCP che supporta I/O standard (stdio) come mezzo di trasporto.

Quando il server Firebase MCP effettua chiamate di strumenti, viene eseguito localmente nel tuo ambiente utilizzando le stesse credenziali utente che autorizzano la CLI Firebase. Può 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 popolari:

{
  "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, esistono due parametri facoltativi che puoi specificare:

• --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, gli strumenti get_project_directory e set_project_directory diventano disponibili 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. Utilizzalo per limitare gli strumenti esposti solo alle funzionalità che utilizzi attivamente. Tieni presente che gli strumenti di base 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 raccolta di prompt precompilati che puoi eseguire; sono ottimizzati per lo sviluppo e l'esecuzione di un'app con Firebase

• Strumenti: un insieme di strumenti destinati all'uso 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'uso 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 precompilati 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 di sviluppo che supportano 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 Firebase MCP fornisce anche una serie di strumenti destinati all'uso da parte di 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. Gli agenti AI che supportano la chiamata di strumenti (come Antigravity, Claude Code o Cursor) possono chiamarli automaticamente per eseguire attività di sviluppo quando necessario.

La tabella seguente descrive gli strumenti resi disponibili 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'uso 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 rese disponibili dal server MCP.

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