firebase-mcp

Firebase MCP 服务

Firebase 模型上下文协议（MCP）服务让 AI 驱动的开发工具能够与 Firebase 项目和应用代码库协同工作。Firebase MCP 服务适用于任何可作为 MCP 客户端的工具，包括：Firebase Studio、Gemini CLI、Claude Code、Cline、Cursor、VS Code Copilot、Windsurf 等！

功能

配置为使用 Firebase MCP 服务的编辑器可以运用 AI 能力帮助你：

• 创建和管理 Firebase 项目 - 初始化新项目、列出现有项目并管理 Firebase 应用
• 管理 Firebase Authentication 用户 - 检索、更新和管理用户账号
• 使用 Cloud Firestore 和 Firebase SQL Connect - 查询、读取、写入和管理数据库文档
• 检索 Firebase SQL Connect 架构 - 借助 AI 生成架构和操作
• 了解安全规则 - 验证和检索 Firestore、Cloud Storage 和 Realtime Database 的安全规则
• 通过 Firebase Cloud Messaging 发送消息 - 向设备和主题发送推送通知
• 访问 Crashlytics 数据 - 调试问题、查看崩溃报告并管理崩溃分析
• 部署到 App Hosting - 监控后端并检索日志
• 使用 Realtime Database - 实时读取和写入数据
• 查询 Cloud Functions 日志 - 检索和分析函数执行日志
• 管理 Remote Config - 获取和更新远程配置模板

部分工具会使用 Firebase 中的 Gemini来帮助你：

• 生成 Firebase SQL Connect 架构和操作
• 向 Gemini 咨询 Firebase 产品

Important： Firebase 中的 Gemini 可能会生成看似合理但事实错误的内容。它可能会给出不准确的信息，这些信息并不代表 Google 的观点。使用 Gemini 的任何输出前，请先进行验证；未经测试的生成代码不要用于生产环境。请勿在聊天中输入个人身份信息（PII）或用户数据。
详细了解 Firebase 中的 Gemini 及其数据使用方式。

安装和设置

前提条件

确保已正确安装 Node.js 和 npm。

基本配置

Firebase MCP 服务可以与任何支持将标准输入/输出（stdio）作为传输方式的 MCP 客户端配合使用。Firebase MCP 服务调用工具时，会使用运行环境中用于授权 Firebase CLI 的同一用户凭据。

以下是一些常见 AI 辅助工具的配置说明：

Gemini CLI

安装适用于 Gemini CLI 的 Firebase 扩展：

gemini extensions install https://github.com/firebase/agent-skills

Claude Code

选项 1：通过插件安装（推荐）

在 Claude Code 中设置 Firebase MCP 服务的最简单方法是安装官方 Firebase 插件：

1. 添加 Claude 插件的 Firebase marketplace：

   claude plugin marketplace add firebase/firebase-tools
   

2. 安装 Firebase 的 Claude 插件：

   claude plugin install firebase@firebase
   

3. 验证安装：

   claude plugin
   

选项 2：手动配置 MCP 服务

或者，你也可以运行以下命令手动配置 Firebase MCP 服务：

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

运行以下命令即可验证安装：

claude mcp list

应该会显示：

firebase: npx -y firebase-tools@latest mcp - ✓ Connected

Cursor

将配置添加到项目目录中的 .cursorrules，或在 Cursor 设置中进行配置：

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

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

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

Firebase Studio

要配置 Firebase Studio 使用 Firebase MCP 服务，请编辑或创建配置文件：.idx/mcp.json

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

用法

配置完成后，MCP 服务会自动向你的 AI 助手提供 Firebase 功能。你可以：

• 请 AI 帮助设置 Firebase 服务
• 查询 Firestore 数据库
• 管理身份验证用户
• 部署到 Firebase Hosting
• 调试 Crashlytics 问题
• 以及更多！

如需查看可用工具和资源的完整列表，请参阅下文的服务功能部分。

文档

如需了解更多信息，请访问 Firebase MCP 服务官方文档。

服务功能

Firebase MCP 服务提供三类功能：工具（执行操作的函数）、提示词（可重复使用的命令模板）和资源（供 AI 模型使用的文档文件）。

工具名称	功能组	描述
apphosting_fetch_logs	apphosting	获取 App Hosting 后端的近期服务日志或构建日志。
apphosting_list_backends	apphosting	列出项目中的 App Hosting 后端、流量配置和自定义域名。
auth_get_users	auth	按 UID、电子邮件地址或电话号码检索 Firebase Auth 用户，或列出所有用户。
auth_update_user	auth	通过启用或停用用户账号，或设置自定义声明来更新账号。
auth_set_sms_region_policy	auth	设置短信区域政策，允许或禁止 Firebase Authentication 使用特定国家/地区代码。
firebase_login	core	将用户登录到 Firebase CLI 和 MCP 服务，或检查当前的身份验证状态。
firebase_logout	core	将用户从 Firebase CLI 和 MCP 服务中登出。
firebase_validate_security_rules	core	验证 Firestore、Storage 或 Realtime Database 安全规则的语法并检查错误。
firebase_get_project	core	获取当前活跃 Firebase 项目的元数据和配置信息。
firebase_list_apps	core	列出活跃项目中注册的所有 Firebase 应用。
firebase_list_projects	core	列出经身份验证的用户有权访问的 Firebase 项目。
firebase_get_sdk_config	core	获取已注册 Firebase 应用的 SDK 配置信息或配置文件内容。
firebase_create_project	core	创建新的 Firebase 项目，或在现有 Google Cloud 项目上启用 Firebase 服务。
firebase_create_app	core	在活跃 Firebase 项目中创建新的 iOS、Android 或 Web 应用。
firebase_create_android_sha	core	为活跃 Firebase 项目中的 Android 应用添加 SHA-1 或 SHA-256 证书哈希值。
firebase_get_environment	core	获取当前 Firebase CLI 和 MCP 环境配置、活跃项目及经身份验证的用户。
firebase_update_environment	core	更新环境设置，例如项目目录、活跃项目或活跃用户账号。
firebase_init	core	在本地项目工作区中初始化并配置 Firebase 服务。
firebase_get_security_rules	core	获取 Firestore、Storage 或 Realtime Database 的活跃安全规则。
firebase_read_resources	core	读取内部 firebase:// 文档资源的内容，或列出所有可用资源。
crashlytics_create_note	crashlytics	为 Android 或 iOS 应用的 Crashlytics 问题添加备注。
crashlytics_delete_note	crashlytics	删除 Android 或 iOS 应用的 Crashlytics 问题备注。
crashlytics_get_issue	crashlytics	获取特定 Crashlytics 问题的详情和元数据。
crashlytics_list_events	crashlytics	列出符合指定问题筛选条件的近期崩溃和异常事件。
crashlytics_batch_get_events	crashlytics	按资源名称获取崩溃和异常事件样本，以用于调试。
crashlytics_list_notes	crashlytics	列出 Android 或 iOS 应用的 Crashlytics 问题所附的所有备注。
crashlytics_get_report	crashlytics	生成 Crashlytics 问题和事件的汇总数值报告。
crashlytics_update_issue	crashlytics	更新 Crashlytics 问题的状态（OPEN 或 CLOSED）。
realtimedatabase_get_data	realtimedatabase	从 Firebase Realtime Database 的指定路径读取数据。
realtimedatabase_set_data	realtimedatabase	将 JSON 数据写入 Firebase Realtime Database 的指定路径。
dataconnect_build	dataconnect	编译 Firebase SQL Connect 架构、操作和连接器，以验证语法和类型。
dataconnect_list_services	dataconnect	列出本地和已部署的 Firebase SQL Connect 服务、架构和连接器。
dataconnect_execute	dataconnect	对 Firebase SQL Connect 服务或模拟器执行 GraphQL 查询或变更。
firestore_delete_document	firestore	使用此工具，根据完整文档路径删除当前项目中数据库里的 Firestore 文档。已知文档的确切路径时，请使用此工具。
firestore_get_documents	firestore	使用此工具，根据完整文档路径获取当前项目中数据库里的一个或多个 Firestore 文档。已知文档的确切路径时，请使用此工具。
firestore_list_collections	firestore	使用此工具获取当前项目中 Firestore 数据库的集合列表。
firestore_query_collection	firestore	查询集合中的 Firestore 文档，可选用筛选条件和排序方式。
functions_get_logs	functions	获取并筛选 Google Cloud Logging 中的 Cloud Functions 日志条目。
functions_list_functions	functions	列出 Firebase 项目中已部署的所有 Cloud Functions。
messaging_send_message	messaging	向设备注册令牌或主题发送 Firebase Cloud Messaging 推送通知。
remoteconfig_get_template	remoteconfig	获取 Firebase Remote Config 模板的活跃版本或指定版本。
remoteconfig_update_template	remoteconfig	发布新的 Firebase Remote Config 模板，或回滚到先前版本。
storage_get_object_download_url	storage	获取 Cloud Storage 存储桶中对象的下载 URL。
提示词名称	功能组	描述
---------------------------------	-------------	-----------------------------------------------------------------------------------------------------------------------------------------------------------------
firebase:deploy	core	使用此命令将资源部署到 Firebase。 参数： <prompt>（可选）：你希望提供的关于部署的任何具体说明
firebase:init	core	使用此命令设置 Firebase 服务，例如后端和 AI 功能。
firestore:generate_security_rules	firestore	为你的项目生成安全的 Firebase Firestore 安全规则及相应的单元测试。
storage:generate_security_rules	storage	为你的项目生成安全的 Firebase Storage 安全规则及相应的单元测试。
crashlytics:connect	crashlytics	使用此命令访问 Firebase 应用的 Crashlytics 数据。
资源名称	描述
--------------------------------	-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
app_id_guide	Firebase App ID 指南：指导编码 Agent 为当前项目选择 Firebase App ID
crashlytics_investigations_guide	Firebase Crashlytics 调查指南：在调查 Crashlytics 问题中报告的错误时为编码 Agent 提供指导，包括诊断和修复崩溃的流程。
crashlytics_issues_guide	Firebase Crashlytics 问题指南：编码 Agent 处理 Crashlytics 问题时的指南，包括优先级规则以及诊断和修复崩溃的流程。
crashlytics_reports_guide	Firebase Crashlytics 报告指南：指导编码 Agent 请求 Crashlytics 报告，包括设置适当的筛选条件以及了解指标的方法。请求任何报告之前，Agent 都应先阅读本指南。
backend_init_guide	Firebase 后端初始化指南：指导编码 Agent 为当前项目配置 Firebase 后端服务
ai_init_guide	Firebase GenAI 初始化指南：指导编码 Agent 使用 Firebase 为当前项目配置 GenAI 功能
firestore_init_guide	Firestore 初始化指南：指导编码 Agent 为当前项目配置 Firestore
firestore_rules_init_guide	Firestore 规则初始化指南：指导编码 Agent 为项目设置 Firestore 安全规则
auth_init_guide	Firebase Authentication 初始化指南：指导编码 Agent 为当前项目配置 Firebase Authentication
hosting_init_guide	Firebase Hosting 部署指南：指导编码 Agent 将当前项目部署到 Firebase Hosting
docs	Firebase 文档：从 Firebase 文档加载纯文本内容，例如，https://firebase.google.com/docs/functions 会转换为 firebase://docs/functions