Firebase MCP Server

社区

让 AI 助手直接操作 Firebase 服务的 MCP 服务器

分类: 数据库第 33 / 58
Stars: ★ 247 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 17 个月前 ⚠
工具数: 12

54FMRS · D

该服务器由社区开发者 gannonh 维护（非 Google 官方），基于 MIT 许可开源，工具覆盖面较完整，文档详细，包含测试 CI 和 Firebase 模拟器测试支持。适合已有 Firebase 项目并使用主流 MCP 客户端的开发者，但需注意服务账号密钥安全及已知的 Zod 验证日志问题。

最强项 · 文档质量 15/20 最弱项 · 安全与权限 6/20

可靠性

9/20

安全与权限

6/20

维护活跃度

11/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: README 提供了 CI 徽章（Firebase Tests CI）和 test:emulator/test:coverage:emulator 脚本，工具列表与参数描述基本一致，但未提供实际工作流文件或测试文件供核验，无法确认覆盖了关键路径。文档中还公开承认 firestore_list_collections 存在未解决的 Zod 校验错误（尽管声称不影响功能），说明声明行为与实际输出模式之间存在已知偏差。按静态核查规则，缺乏可核验的执行证据，评分不能高于12分。
安全与权限 6/20: 服务器要求使用 Firebase 服务账户密钥（完整管理员权限），未见任何按集合/路径或操作类型进行的最小权限范围限定。firestore_delete_document、storage_upload 等具有不可逆或覆盖性影响的操作，README 中未描述任何二次确认或安全防护机制。新增的 HTTP 传输模式仅描述了会话管理，未提及任何身份验证机制，若在非受信网络暴露则存在被未授权调用的风险。未达到红线级别（无恶意代码、无凭据窃取、无伪造身份），但权限范围、破坏性操作确认、HTTP 认证均存在明显缺口。
维护活跃度 11/20: 项目具备 MIT 许可证、未归档、有 CI 测试徽章，说明存在一定的持续维护迹象；星标数与未解决 issue 数量（248/16）表明有一定关注度，但 README 未提供版本发布记录、更新日志、安全响应渠道或维护者响应时间的证据，治理透明度不足。
文档质量 15/20: 文档结构清晰，涵盖安装（npx 与本地两种方式）、环境变量（必需/可选）、按服务分类的工具参数表、故障排查、日志调试、项目结构和 HTTP 传输配置等内容，并主动披露了已知缺陷。但缺少完整的参数类型/可选参数说明、成本或配额提示，以及 HTTP 传输的安全性说明，存在文档假设未言明的空白。
安装易用性 13/20: 为 npx 和本地安装均提供了具体的 JSON 配置示例，并列出了 Claude Desktop、VS Code/Augment、Cursor 的配置路径，步骤总体清晰。但仍需用户自行完成 Firebase 项目创建、服务账户密钥下载等外部准备工作，且没有可供核验的安装成功证据（如自动化测试或截图），按静态核查规则设置分数上限为15。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络连接数据库

适合谁

已在 Firebase 生态中存储数据并希望让 AI 助手直接读写这些数据的开发者
使用 Claude Desktop、Cursor、VS Code 或 Augment Code 等 MCP 客户端的用户
需要文档数据库、文件存储和用户查询组合能力的场景

不适合谁

没有 Firebase 项目或服务账号凭据的用户
需要对 Firebase 进行管理操作（如项目管理、函数部署）的场景
不使用 MCP 客户端且无法配置环境变量的环境

所需权限

需要 Firebase 服务账号私钥 JSON 文件（SERVICE_ACCOUNT_KEY_PATH）
服务账号需具备 Firestore、Storage 和身份验证相应服务的权限
需要指定或默认的 Firebase Storage 存储桶名称

风险与副作用

服务账号私钥具有较高权限，路径配置不当或泄露可能导致数据被完全访问
AI 助手可通过工具删除 Firestore 文档或上传覆盖存储文件，存在误操作风险
firestore_list_collections 工具可能在客户端日志中触发 MCP SDK 的 Zod 验证错误（已知问题，虽不影响功能但可能引起困扰）
某些 Firestore 查询需要在 Firebase 控制台手动创建复合索引才能运行

安装接入

准备工作

运行环境：Node.js

SERVICE_ACCOUNT_KEY_PATH 必填密钥 Firebase 服务账号私钥 JSON 的绝对路径；在 Firebase 控制台 → 项目设置 → 服务账号中生成。

其他可选配置项（6 个）

FIREBASE_STORAGE_BUCKET 可选 Firebase Storage 存储桶名称，默认为 [projectId].appspot.com；在 Firebase 控制台的 Storage 页面确认。

MCP_TRANSPORT 可选传输类型，stdio 或 http，默认 stdio。

MCP_HTTP_PORT 可选 HTTP 传输监听端口，默认 3000。

MCP_HTTP_HOST 可选 HTTP 传输监听主机，默认 localhost。

MCP_HTTP_PATH 可选 HTTP 传输路径，默认 /mcp。

DEBUG_LOG_FILE 可选设为 true 写入 ~/.firebase-mcp/debug.log，或设为自定义文件路径以启用文件日志。

在 Firebase 控制台 → 项目设置 → 服务账号中生成新的私钥 JSON 文件并安全保存。
在 MCP 客户端配置文件（如 Claude Desktop 的 claude_desktop_config.）中添加服务器配置，推荐使用 npx：command 为 npx，args 为 ["-y","@gannonh/firebase-mcp"]。
设置环境变量 SERVICE_ACCOUNT_KEY_PATH（私钥 JSON 绝对路径，必需）和 FIREBASE_STORAGE_BUCKET（可选，默认为 [projectId].appspot.com）。
可选配置 HTTP 传输（MCP_TRANSPORT=http、MCP_HTTP_PORT 等）或调试日志（DEBUG_LOG_FILE）。
可让 AI 客户端执行“测试所有 Firebase MCP 工具”来验证安装。

claude_desktop_config.json

{"firebase-mcp":{"command":"npx","args":["-y","@gannonh/firebase-mcp"],"env":{"SERVICE_ACCOUNT_KEY_PATH":"/absolute/path/to/serviceAccountKey.","FIREBASE_STORAGE_BUCKET":"your-project-id.firebasestorage.app"}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "firebase-mcp": {
    "command": "npx",
    "args": [
      "-y",
      "@gannonh/firebase-mcp"
    ],
    "env": {
      "SERVICE_ACCOUNT_KEY_PATH": "/absolute/path/to/serviceAccountKey.",
      "FIREBASE_STORAGE_BUCKET": "your-project-id.firebasestorage.app"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

生成并校验客户端配置

验证是否装好

安装后向 AI 客户端发送："Please test all Firebase MCP tools."，或检查工具列表中是否出现 firestore_get_document 等工具。

常见排障

若提示“The specified bucket does not exist”，请在 Firebase 控制台核实存储桶名称并正确设置 FIREBASE_STORAGE_BUCKET
若提示“Firebase is not initialized”，请检查服务账号密钥路径是否为正确的绝对路径，并确认服务账号权限
若提示需要复合索引，请点击错误信息中的 URL 到 Firebase 控制台创建索引后重试
firestore_list_collections 的 Zod 验证错误为已知日志级问题，不影响实际功能
可通过设置 DEBUG_LOG_FILE 启用文件日志（默认 ~/.firebase-mcp/debug.log）或使用 MCP Inspector 进行调试

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在 Firestore 的 users 集合里添加一个文档，包含姓名和邮箱字段
列出我 Firebase Storage 中 reports 目录下的所有文件
根据邮箱查询这个用户的详细信息
把 https://example.com/file.pdf 上传到 Storage 的 docs 路径下

工具能力 12

firestore_add_document 写入

向集合添加文档

firestore_list_documents 只读

列出集合中的文档并支持过滤

firestore_get_document 只读

获取指定文档

firestore_update_document 写入

更新现有文档

firestore_delete_document 破坏性

删除文档

firestore_list_collections 只读

列出根集合

firestore_query_collection_group 只读

跨子集合查询

storage_list_files 只读

列出目录中的文件

展开其余 4 个工具

storage_get_file_info 只读

获取文件元数据和下载 URL

storage_upload 写入

从内容上传文件

storage_upload_from_url 写入

从 URL 上传文件

auth_get_user 只读

按 ID 或邮箱获取用户

使用场景

通过 AI 助手对 Firestore 进行文档的增删改查和子集合查询

管理 Firebase Storage 中的文件，包括列出、查询元数据和从内容或 URL 上传文件

按 ID 或邮箱查询 Firebase 身份验证用户

以独立 HTTP 服务形式运行，供多个客户端共享连接

支持客户端

Claude Desktop

Augment Code

VS Code

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Firebase MCP 是一个开源（MIT 许可）的 Model Context Protocol 服务器，使 AI 助手能够直接与 Firebase 服务交互，涵盖 Firestore 文档数据库操作、Firebase Storage 文件管理（含上传功能）以及身份验证用户查询。支持通过 npx 或本地 Node.js 安装，默认使用 stdio 传输，也可配置为 HTTP 传输以供多客户端共享。适用于 Claude Desktop、Augment Code、VS Code 和 Cursor 等 MCP 客户端。