firebase-mcp

概述

Firebase MCP 是一个文档完善的 Model Context Protocol 服务器，使 AI 助手能够直接与 Firebase 服务交互。它提供了 Firestore 文档操作、Firebase Storage 文件管理和用户身份验证的全面工具。该服务器支持 stdio 和 HTTP 传输，允许与 Claude Desktop、VS Code 和 Cursor 等 MCP 客户端灵活集成。实现包括适当的错误处理、调试功能和详细的 API 参考。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• firestore_add_document

  Add a document to a collection

  试试:Add a new user document to the users collection试试:Create a new product in the inventory collection
• firestore_list_documents

  List documents with filtering

  试试:Show all documents in the orders collection试试:List all blog posts sorted by date
• firestore_get_document

  Get a specific document

  试试:Retrieve user profile with ID 123试试:Get product details for SKU 456
• firestore_update_document

  Update an existing document

  试试:Update user email for user ID 123试试:Modify product price for SKU 456
• firestore_delete_document

  Delete a document

  试试:Delete user profile with ID 123试试:Remove product with SKU 456
• firestore_list_collections

  List root collections

  试试:Show all collections in the database试试:List all available data collections
• firestore_query_collection_group

  Query across subcollections

  试试:Find all comments across all posts试试:Query all user activities
• storage_list_files

  List files in a directory

  试试:Show all files in the images folder试试:List all documents in the reports directory
• storage_get_file_info

  Get file metadata and URL

  试试:Get details for logo.png试试:Retrieve metadata for report.pdf
• storage_upload

  Upload file from content

  试试:Upload my image to Firebase Storage试试:Add document to files collection
• storage_upload_from_url

  Upload file from URL

  试试:Download and save image from https://example.com/photo.jpg试试:Copy file from public URL to storage
• auth_get_user

  Get user by ID or email

  试试:Retrieve user with email user@example.com试试:Get details for user ID 123

可对比工具

安装

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

FAQ

firestore_list_collections 的 Zod 验证错误是什么？

这是一个已知问题，工具可能会在客户端日志中返回验证错误。尽管有错误消息，查询仍能正常工作并返回正确的集合数据。这是一个不影响功能的日志级别错误。

如何为 MCP 服务器启用调试？

将 DEBUG_LOG_FILE 环境变量设置为 'true' 以记录到默认位置 (~/.firebase-mcp/debug.log) 或指定自定义文件路径。您还可以使用 'tail -f' 或捕获 stderr 实时查看日志。

firebase-mcp 对比