Firebase MCP 是一个面向 Firebase 的 Model Context Protocol（MCP）服务器，目标是让 AI 助手能够直接与 Firebase 服务交互。根据仓库说明，它覆盖的服务包括：Firestore（文档数据库操作）、Storage（文件管理，带较完善的上传能力）、Authentication（用户管理与验证）。该服务器可与 Claude Desktop、Augment Code、VS Code、Cursor 等 MCP 客户端应用配合使用。
安装与使用 使用前提：需要一个带服务账号凭据的 Firebase 项目，以及 Node.js 环境。安装方式为将服务器配置添加到 MCP 设置文件；MCP 服务器可以手动安装，也可以在运行时通过 npx 安装（推荐），安装方式决定配置方式。对应的配置位置示例：Claude Desktop 为 ~/Library/Application Support/Claude/claude_desktop_config.json；Augment 为 ~/Library/Application Support/Code/User/settings.json；Cursor 为 [project root]/.cursor/mcp.json。安装后可在 AI 客户端中要求“请测试所有 Firebase MCP 工具”以验证安装。
配置 Firebase 配置步骤：进入 Firebase Console 的 Project Settings → Service Accounts，点击 Generate new private key，并安全保存 JSON 文件。环境变量包括：SERVICE_ACCOUNT_KEY_PATH（Firebase 服务账号密钥 JSON 的路径，必填）；FIREBASE_STORAGE_BUCKET（Firebase Storage 的桶名，默认为 [projectId].appspot.com）；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，设为某个文件路径时记录到自定义位置）。客户端集成同样编辑上述对应的配置文件。
API 与开发 仓库列出了 Firestore 工具与 Authentication 工具的 API Reference（具体工具清单未在给定资料中展开）。开发者指南包含安装与构建：先安装并启动 Firebase 模拟器，再运行测试。项目结构、贡献流程（Fork 仓库、创建功能分支、带测试实现改动，要求 80%+ 覆盖率、提交 pull request）以及 MIT 许可证均有说明。
HTTP 传输 Firebase MCP 在默认 stdio 之外新增支持 HTTP 传输，可将服务器作为独立 HTTP 服务运行，供多个客户端访问。使用时以 HTTP 传输方式运行服务器，并在 MCP 客户端中配置连接 HTTP 端点。HTTP 传输支持会话管理，多个客户端可连接到同一服务器实例，每个客户端获得唯一会话 ID，用于在请求之间维持状态。
故障排查 资料列出若干常见问题与处理方式：出现“The specified bucket does not exist”时，在 Firebase Console → Storage 核对桶名，并在 FIREBASE_STORAGE_BUCKET 环境变量中设置正确桶名；出现“Firebase is not initialized”时，检查服务账号密钥路径是否正确且为绝对路径，并确认服务账号拥有 Firebase 服务的相应权限；出现“This query requires a composite index”时，使用错误信息中提供的 URL 在 Firebase Console 创建所需索引，待索引创建后（可能需要几分钟）重试查询；使用 firestore_list_collections 工具时若出现消息为“Expected object, received boolean”的 Zod 校验错误，可通过启用文件日志或在 MCP 客户端配置中启用日志来协助诊断，并可实时查看日志；MCP Inspector 提供交互式调试。
已知问题 firestore_list_collections 工具可能在客户端日志中返回 Zod 校验错误。仓库说明这是 MCP SDK 中的错误校验错误，调查确认响应中并不存在布尔值；尽管出现该错误信息，查询仍能正确工作并返回应有的集合数据，这是不影响功能的日志级错误。
响应格式 Storage 上传响应有示例，并说明了向用户展示的形态（具体格式细节未在资料中完整给出）。
