Firebase MCP Server (Official)

什么是 Firebase MCP Server (Official)？

Firebase MCP Server (Official) 是 Google 官方的 Firebase MCP 服务器，内置于 Firebase CLI，通过 npx -y firebase-tools@latest mcp 启动。它让 AI 编程工具能够管理 Firebase 项目、Auth 用户、Firestore、安全规则、Crashlytics 和部署。

它是一个本地服务器，通过 stdio 与客户端通信。工具调用使用你机器上授权 Firebase CLI 的同一套凭据：已登录的用户，或 Application Default Credentials。源码位于 firebase/firebase-tools 仓库（MIT），完整参考见 Firebase MCP 服务器官方文档。

如何使用 Firebase MCP Server (Official)？

你需要可用的 Node.js 和 npm。不需要单独的 API Key，服务器直接使用你的 Firebase CLI 登录状态。如果还没登录，运行 npx -y firebase-tools@latest login，或者让智能体调用 firebase_login 工具。

所有客户端都启动同一条命令：npx -y firebase-tools@latest mcp。

Claude Code

推荐安装官方 Firebase 插件，它还会一并带来 Firebase agent skills：

claude plugin marketplace add firebase/firebase-tools
claude plugin install firebase@firebase

也可以只添加 MCP 服务器。在应用目录下运行以下命令并检查：

claude mcp add firebase npx -- -y firebase-tools@latest mcp
claude mcp list

列表中应显示 firebase: npx -y firebase-tools@latest mcp - ✓ Connected。

Claude Desktop

打开 Claude > Settings > Developer > Edit Config，添加：

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

Cursor

从 Cursor Marketplace 安装 Firebase 插件；或把同样的 mcpServers 配置写入 .cursor/mcp.json（单个项目）或 ~/.cursor/mcp.json（全局）。

VS Code

VS Code Copilot 请编辑工作区中的 .vscode/mcp.json：

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

Windsurf

把同样的 mcpServers 配置添加到 ~/.codeium/windsurf/mcp_config.json。Google 文档还介绍了 Antigravity（从 MCP Store 安装）、Cline 和 Gemini CLI 扩展的配置方法。

可选参数

--dir 指定包含 firebase.json 的目录的绝对路径。--only 只启用你列出的功能组，核心工具始终可用。

"args": ["-y", "firebase-tools@latest", "mcp", "--dir", "/Users/you/my-project", "--only", "auth,firestore,storage"]

Firebase MCP Server (Official) 的主要功能

• 官方出品，由 Firebase 团队在 firebase-tools 中维护（MIT，持续发布新版本）
• 在对话中创建 Firebase 项目和应用、获取 SDK 配置、运行 firebase init 和部署
• 读写 Cloud Firestore 和 Realtime Database，并管理 Firestore 数据库、索引和备份
• 校验并获取 Firestore、Cloud Storage 和 Realtime Database 的安全规则
• 排查 Crashlytics 问题、事件和报告，读取 Cloud Functions 和 App Hosting 日志
• 发送 Firebase Cloud Messaging 通知，更新 Remote Config 模板
• 除工具外还提供提示词（/firebase:init、/firebase:deploy）和资源（配置指南、firebase://docs）
• 用 --only 选择功能组，让工具列表保持精简

Firebase MCP Server (Official) 工具

工具按功能组划分。运行 npx firebase-tools@latest mcp --generate-tool-list 可以列出全部工具。

• core：项目、应用和环境，包括 firebase_list_projects、firebase_create_project、firebase_get_sdk_config、firebase_init、firebase_deploy、firebase_get_security_rules 和 firebase_validate_security_rules。
• firestore：文档增删改查和查询（firestore_query_collection、firestore_run_aggregation_query），以及数据库、索引和备份计划管理。
• auth：auth_get_users、auth_update_user（停用账号、设置自定义声明）和 auth_set_sms_region_policy。
• crashlytics：crashlytics_get_issue、crashlytics_list_events、crashlytics_get_report、备注，以及 crashlytics_update_issue。
• dataconnect、realtimedatabase、storage、messaging（messaging_send_message）、remoteconfig、functions（functions_get_logs）和 apphosting（apphosting_fetch_logs）。
• developerknowledge：检索 Google 开发者文档并基于其回答问题。

Firebase MCP Server (Official) 的使用场景

• 新建应用：“为这个 Web 应用配置 Firebase Auth 和 Firestore”（/firebase:init 提示词）。
• 调试数据：“查询 orders 集合中 status 为 COMPLETED 的文档并统计数量。”
• 编写规则：“为这个数据结构生成 Firestore 安全规则和单元测试。”
• 修复崩溃：“列出我的 Android 应用最严重的 Crashlytics 问题，并给出修复建议。”
• 发布：“部署 hosting 和 functions，然后检查部署状态。”
• 用户支持：“找到这个邮箱对应的 Auth 用户并停用该账号。”

Firebase MCP Server (Official) 与替代方案对比

官方服务器是 Firebase CLI 的一部分，覆盖的产品最多，并且使用你的 CLI 登录状态，不需要服务账号密钥。gannonh 开发的社区版 Firebase MCP Server（@gannonh/firebase-mcp）规模更小，专注于 Auth、Firestore 和 Storage。它使用服务账号密钥文件，适合无界面环境。如果只需要 Firestore，Google 在其 google/mcp 目录中还列出了一个远程 Firestore MCP 服务器。

Firebase MCP Server (Official) 常见问题排查

• 工具调用报认证错误：服务器没有 Firebase CLI 凭据。运行 npx -y firebase-tools@latest login，或让智能体调用 firebase_login。在 CI 中则会使用 Application Default Credentials。
• 项目不对或提示没有 firebase.json：用 --dir 传入项目目录的绝对路径，或让智能体调用 firebase_update_environment 切换项目目录或当前项目。
• 工具太多，客户端难以处理：添加 --only，只保留需要的功能组，例如 --only firestore,auth。
• 服务器无法启动：所有配置都通过 npx 运行，请确认 Node.js 和 npm 已安装，并且在客户端使用的 PATH 中。