Firebase MCP Server

Firebase MCP Server

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 - 获取和更新远程配置模板

部分工具使用 Gemini in Firebase 来帮助你：

• 生成 Firebase SQL Connect 架构和操作
• 咨询 Gemini 关于 Firebase 产品的问题

重要提示： Gemini in Firebase 可能生成看似合理但实际不正确的输出。它可能返回不准确的信息，这些信息不代表 Google 的观点。在使用 Gemini 的输出之前请务必验证，并且不要在生产环境中使用未经测试的生成代码。请勿在聊天中输入个人身份信息（PII）或用户数据。
了解更多关于 Gemini in Firebase 及其如何使用你的数据 的信息。

安装与设置

前提条件

确保你已安装可用的 Node.js 和 npm。

基本配置

Firebase MCP 服务器可与任何支持标准输入输出（stdio）作为传输介质的 MCP 客户端配合使用。当 Firebase MCP 服务器进行工具调用时，它使用与运行环境中授权 Firebase CLI 相同的用户凭据。

以下是常用 AI 辅助工具的配置说明：

Gemini CLI

安装 Firebase 扩展 for Gemini CLI：

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

Claude Code

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

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

1. 添加 Firebase 的 Claude 插件市场：

   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 指南：指导编码代理在当前项目中选择 Firebase App ID
crashlytics_investigations_guide	Firebase Crashlytics 调查指南：指导编码代理调查 Crashlytics 问题中报告的 bug，包括诊断和修复崩溃的流程。
crashlytics_issues_guide	Firebase Crashlytics 问题指南：指导编码代理处理 Crashlytics 问题，包括优先级规则以及诊断和修复崩溃的流程。
crashlytics_reports_guide	Firebase Crashlytics 报告指南：指导编码代理请求 Crashlytics 报告，包括设置适当的过滤器以及如何理解指标。代理在请求任何报告之前应阅读此指南。
backend_init_guide	Firebase 后端初始化指南：指导编码代理在当前项目中配置 Firebase 后端服务
ai_init_guide	Firebase GenAI 初始化指南：指导编码代理利用 Firebase 在当前项目中配置 GenAI 功能
firestore_init_guide	Firestore 初始化指南：指导编码代理在当前项目中配置 Firestore
firestore_rules_init_guide	Firestore 规则初始化指南：指导编码代理在项目中设置 Firestore 安全规则
auth_init_guide	Firebase Authentication 初始化指南：指导编码代理在当前项目中配置 Firebase Authentication
hosting_init_guide	Firebase Hosting 部署指南：指导编码代理在当前项目中部署到 Firebase Hosting
docs	Firebase 文档：从 Firebase 文档中加载纯文本内容，例如 https://firebase.google.com/docs/functions 变为 firebase://docs/functions