适合谁
- 已在 Firebase 生态中存储数据并希望让 AI 助手直接读写这些数据的开发者
- 使用 Claude Desktop、Cursor、VS Code 或 Augment Code 等 MCP 客户端的用户
- 需要文档数据库、文件存储和用户查询组合能力的场景
F
54FMRS · D
该服务器由社区开发者 gannonh 维护（非 Google 官方），基于 MIT 许可开源，工具覆盖面较完整，文档详细，包含测试 CI 和 Firebase 模拟器测试支持。适合已有 Firebase 项目并使用主流 MCP 客户端的开发者，但需注意服务账号密钥安全及已知的 Zod 验证日志问题。
Firebase MCP 是一个开源（MIT 许可）的 Model Context Protocol 服务器，使 AI 助手能够直接与 Firebase 服务交互，涵盖 Firestore 文档数据库操作、Firebase Storage 文件管理（含上传功能）以及身份验证用户查询。支持通过 npx 或本地 Node.js 安装，默认使用 stdio 传输，也可配置为 HTTP 传输以供多客户端共享。适用于 Claude Desktop、Augment Code、VS Code 和 Cursor 等 MCP 客户端。
工具能力
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
列出目录中的文件
storage_get_file_info
获取文件元数据和下载 URL
storage_upload
从内容上传文件
storage_upload_from_url
从 URL 上传文件
auth_get_user
按 ID 或邮箱获取用户
安装接入
- 在 Firebase 控制台 → 项目设置 → 服务账号中生成新的私钥 JSON 文件并安全保存。2. 在 MCP 客户端配置文件（如 Claude Desktop 的 claude_desktop_config.）中添加服务器配置，推荐使用 npx：command 为 npx，args 为 ["-y","@gannonh/firebase-mcp"]。3. 设置环境变量 SERVICE_ACCOUNT_KEY_PATH（私钥 JSON 绝对路径，必需）和 FIREBASE_STORAGE_BUCKET（可选，默认为 [projectId].appspot.com）。4. 可选配置 HTTP 传输（MCP_TRANSPORT=http、MCP_HTTP_PORT 等）或调试日志（DEBUG_LOG_FILE）。5. 可让 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"}}}
选型与风险
不适合谁
- 没有 Firebase 项目或服务账号凭据的用户
- 需要对 Firebase 进行管理操作（如项目管理、函数部署）的场景
- 不使用 MCP 客户端且无法配置环境变量的环境
所需权限
- 需要 Firebase 服务账号私钥 JSON 文件（SERVICE_ACCOUNT_KEY_PATH）
- 服务账号需具备 Firestore、Storage 和身份验证相应服务的权限
- 需要指定或默认的 Firebase Storage 存储桶名称
风险与副作用
- 服务账号私钥具有较高权限，路径配置不当或泄露可能导致数据被完全访问
- AI 助手可通过工具删除 Firestore 文档或上传覆盖存储文件，存在误操作风险
- firestore_list_collections 工具可能在客户端日志中触发 MCP SDK 的 Zod 验证错误（已知问题，虽不影响功能但可能引起困扰）
- 某些 Firestore 查询需要在 Firebase 控制台手动创建复合索引才能运行
常见排障
- 若提示“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 进行文档的增删改查和子集合查询
管理 Firebase Storage 中的文件，包括列出、查询元数据和从内容或 URL 上传文件
按 ID 或邮箱查询 Firebase 身份验证用户
以独立 HTTP 服务形式运行，供多个客户端共享连接
支持客户端
Claude Desktop完整支持
Augment Code完整支持
VS Code完整支持
Cursor完整支持