Firebase MCP 伺服器

Firebase MCP 伺服器是本機 Model Context Protocol (MCP) 伺服器，可在開發環境中執行，讓 AI 輔助開發人員工具能夠處理 Firebase 專案和應用程式的程式碼集。

Firebase MCP 伺服器可與任何能做為 MCP 用戶端的工具搭配使用，包括：Antigravity、Claude Code 和 Claude Desktop、Cline、Cursor、VS Code Copilot、Windsurf 等等！

arrow_downward 跳至設定說明

MCP 伺服器的優點

設定為使用 Firebase MCP 伺服器的編輯器可運用 AI 功能，協助您：

• 建立及管理 Firebase 專案
• 管理 Firebase Authentication 使用者
• 處理 Cloud Firestore 和 Firebase SQL Connect 中的資料
• 擷取 Firebase SQL Connect 個結構定義
• 瞭解 Cloud Firestore 和 Cloud Storage for Firebase 的安全性規則
• 使用 Firebase Cloud Messaging 傳送訊息

這些只是部分清單，如要查看編輯器可用的完整工具清單，請參閱「伺服器功能」一節。

設定 MCP 用戶端

Firebase MCP 伺服器是本機 MCP 伺服器，可與任何支援標準 I/O (stdio) 做為傳輸媒介的 MCP 用戶端搭配使用。

Firebase MCP 伺服器發出工具呼叫時，會使用授權 Firebase CLI 的相同使用者憑證，在本機環境中執行。視環境而定，這可能是已登入的使用者或應用程式預設憑證。

事前準備

請確認 Node.js 和 npm 已順利安裝。

基本設定

以下是搭配一些熱門 AI 輔助工具使用 Firebase MCP 伺服器的基本設定說明：

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

選用設定

除了先前顯示的每個用戶端基本設定外，您還可以指定兩個選用參數：

• --dir ABSOLUTE_DIR_PATH：含有 firebase.json 的目錄絕對路徑，用於為 MCP 伺服器設定專案環境。如未指定，系統會提供 get_project_directory 和 set_project_directory 工具，且預設目錄會是啟動 MCP 伺服器的目前使用的目錄。

• --only FEATURE_1,FEATURE_2：以半形逗號分隔的清單，列出要啟用的功能群組。使用這項功能，即可限制僅顯示您目前使用的功能。請注意，核心工具一律可供使用。

例如：

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

MCP 伺服器功能

Firebase MCP 伺服器提供三種不同類別的 MCP 功能：

• 提示：可執行的預先撰寫提示程式庫，經過最佳化調整，可使用 Firebase 開發及執行應用程式

• 工具：這是一組供 AI 代理程式使用的工具，可協助代理程式直接處理 Firebase 專案 (須經您核准！)

• 資源：供 AI 代理程式使用的文件檔案，可提供更多指引和背景資訊，協助完成工作或目標

提示

Firebase MCP 伺服器內建預先寫入的提示程式庫，可協助您開發及執行 Firebase 應用程式。你可以使用這些提示詞，透過代理式 AI 助理完成各種常見任務或目標。

下表說明 MCP 伺服器提供的提示。

許多支援 MCP 的開發工具都提供便利的方式來執行這些提示。例如，以斜線指令的形式：

/firebase:init

在支援的環境中，只要開始輸入 /firebase:，即可查看可用提示清單。

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

工具

Firebase MCP 伺服器也提供多種工具，供 AI 代理使用，直接處理 Firebase 專案 (須經您核准！)。與提示不同，您不會直接呼叫這些工具，而是由支援工具呼叫的 AI 代理程式 (例如 Antigravity、Claude Code 或 Cursor) 在需要時自動呼叫這些工具，執行開發工作。

下表說明 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"}
        }
      }
    ]
  }
}

資源

MCP 伺服器會提供資源，也就是供 AI 代理使用的說明文件。支援使用資源的代理程式會自動在工作階段內容中加入相關資源。

下表說明 MCP 伺服器提供的資源。

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