Firebase MCP Server

Firebase MCP Server

Firebase Model Context Protocol (MCP) Server cung cấp cho các công cụ phát triển hỗ trợ AI khả năng làm việc với các dự án Firebase và mã nguồn ứng dụng của bạn. Firebase MCP server hoạt động với bất kỳ công cụ nào có thể đóng vai trò là MCP client, bao gồm: Firebase Studio, Gemini CLI, Claude Code, Cline, Cursor, VS Code Copilot, Windsurf, và nhiều hơn nữa!

Tính năng

Một trình soạn thảo được cấu hình để sử dụng Firebase MCP server có thể dùng các khả năng AI của nó để giúp bạn:

• Tạo và quản lý dự án Firebase - Khởi tạo dự án mới, liệt kê các dự án hiện có và quản lý ứng dụng Firebase
• Quản lý người dùng Firebase Authentication - Truy xuất, cập nhật và quản lý tài khoản người dùng
• Làm việc với Cloud Firestore và Firebase SQL Connect - Truy vấn, đọc, ghi và quản lý tài liệu cơ sở dữ liệu
• Truy xuất lược đồ Firebase SQL Connect - Tạo lược đồ và thao tác với sự trợ giúp của AI
• Hiểu các quy tắc bảo mật - Xác thực và truy xuất các quy tắc bảo mật cho Firestore, Cloud Storage và Realtime Database
• Gửi tin nhắn với Firebase Cloud Messaging - Gửi thông báo đẩy đến thiết bị và chủ đề
• Truy cập dữ liệu Crashlytics - Gỡ lỗi sự cố, xem báo cáo sự cố và quản lý phân tích sự cố
• Triển khai lên App Hosting - Giám sát backend và truy xuất nhật ký
• Làm việc với Realtime Database - Đọc và ghi dữ liệu theo thời gian thực
• Truy vấn nhật ký Cloud Functions - Truy xuất và phân tích nhật ký thực thi hàm
• Quản lý Remote Config - Lấy và cập nhật các mẫu cấu hình từ xa

Một số công cụ sử dụng Gemini trong Firebase để giúp bạn:

• Tạo lược đồ và thao tác Firebase SQL Connect
• Tham khảo ý kiến Gemini về các sản phẩm Firebase

Quan trọng: Gemini trong Firebase có thể tạo ra đầu ra có vẻ hợp lý nhưng thực tế không chính xác. Nó có thể phản hồi với thông tin không chính xác không đại diện cho quan điểm của Google. Hãy xác thực tất cả đầu ra từ Gemini trước khi sử dụng và không sử dụng mã được tạo chưa kiểm thử trong môi trường production. Không nhập thông tin nhận dạng cá nhân (PII) hoặc dữ liệu người dùng vào cuộc trò chuyện.
Tìm hiểu thêm về Gemini trong Firebase và cách nó sử dụng dữ liệu của bạn.

Cài đặt và Thiết lập

Điều kiện tiên quyết

Đảm bảo bạn đã cài đặt Node.js và npm hoạt động.

Cấu hình Cơ bản

Firebase MCP server có thể hoạt động với bất kỳ MCP client nào hỗ trợ I/O tiêu chuẩn (stdio) làm phương tiện truyền tải. Khi Firebase MCP server thực hiện các lệnh gọi công cụ, nó sử dụng cùng thông tin xác thực người dùng đã ủy quyền cho Firebase CLI trong môi trường nơi nó đang chạy.

Dưới đây là hướng dẫn cấu hình cho các công cụ hỗ trợ AI phổ biến:

Gemini CLI

Cài đặt tiện ích mở rộng Firebase cho Gemini CLI:

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

Claude Code

Tùy chọn 1: Cài đặt qua plugin (Khuyến nghị)

Cách dễ nhất để thiết lập Firebase MCP server trong Claude Code là cài đặt plugin Firebase chính thức:

1. Thêm marketplace Firebase cho các plugin Claude:

   claude plugin marketplace add firebase/firebase-tools
   

2. Cài đặt plugin Claude cho Firebase:

   claude plugin install firebase@firebase
   

3. Xác minh cài đặt:

   claude plugin
   

Tùy chọn 2: Cấu hình MCP server thủ công

Ngoài ra, bạn có thể cấu hình thủ công Firebase MCP server bằng cách chạy:

claude mcp add firebase npx -- -y firebase-tools@latest mcp

Bạn có thể xác minh cài đặt bằng cách chạy:

claude mcp list

Nó sẽ hiển thị:

firebase: npx -y firebase-tools@latest mcp - ✓ Connected

Cursor

Thêm vào .cursorrules trong thư mục dự án của bạn hoặc cấu hình trong cài đặt Cursor:

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Windsurf

Thêm vào ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Firebase Studio

Để cấu hình Firebase Studio sử dụng Firebase MCP server, hãy chỉnh sửa hoặc tạo tệp cấu hình: .idx/mcp.json

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Sử dụng

Sau khi được cấu hình, MCP server sẽ tự động cung cấp các khả năng Firebase cho trợ lý AI của bạn. Bạn có thể:

• Yêu cầu AI giúp thiết lập các dịch vụ Firebase
• Truy vấn cơ sở dữ liệu Firestore của bạn
• Quản lý người dùng xác thực
• Triển khai lên Firebase Hosting
• Gỡ lỗi các sự cố Crashlytics
• Và nhiều hơn nữa!

Để biết danh sách đầy đủ các công cụ và tài nguyên có sẵn, hãy xem phần Khả năng của Server bên dưới.

Tài liệu

Để biết thêm thông tin, hãy truy cập tài liệu chính thức của Firebase MCP server.

Khả năng của Server

Firebase MCP server cung cấp ba loại khả năng: Công cụ (các hàm thực hiện hành động), Lời nhắc (mẫu lệnh có thể tái sử dụng) và Tài nguyên (tệp tài liệu cho các mô hình AI).

Tên công cụ	Nhóm tính năng	Mô tả
apphosting_fetch_logs	apphosting	Sử dụng để lấy các bản ghi gần đây nhất cho một backend App Hosting được chỉ định. Nếu buildLogs được chỉ định, các bản ghi từ quá trình build cho bản build mới nhất sẽ được trả về. Các bản ghi gần đây nhất được liệt kê trước.
apphosting_list_backends	apphosting	Sử dụng để truy xuất danh sách các backend App Hosting trong dự án hiện tại. Danh sách trống có nghĩa là không có backend nào. uri là URL công khai của backend. Một backend đang hoạt động sẽ có một mảng managed_resources chứa một mục run_service. run_service.service đó là tên tài nguyên của dịch vụ Cloud Run đang phục vụ backend App Hosting. Phân đoạn cuối cùng của tên đó là ID dịch vụ. domains là danh sách các tên miền được liên kết với backend. Chúng có loại CUSTOM hoặc DEFAULT. Mỗi backend nên có một tên miền DEFAULT. Tên miền thực tế mà người dùng sẽ sử dụng để kết nối với backend là tham số cuối cùng của tên tài nguyên tên miền. Nếu một tên miền tùy chỉnh được thiết lập đúng cách, nó sẽ có các trạng thái kết thúc bằng ACTIVE.
auth_get_users	auth	Sử dụng để truy xuất một hoặc nhiều người dùng Firebase Auth dựa trên danh sách UID hoặc danh sách email.
auth_update_user	auth	Sử dụng để vô hiệu hóa, kích hoạt hoặc đặt một xác nhận tùy chỉnh trên tài khoản của một người dùng cụ thể.
auth_set_sms_region_policy	auth	Sử dụng để đặt chính sách vùng SMS cho Firebase Authentication nhằm hạn chế các vùng có thể nhận tin nhắn văn bản dựa trên danh sách CHO PHÉP hoặc TỪ CHỐI các mã quốc gia. Chính sách này sẽ ghi đè lên bất kỳ chính sách hiện có nào khi được đặt.
firebase_login	core	Sử dụng để đăng nhập người dùng vào Firebase CLI và máy chủ Firebase MCP. Điều này yêu cầu Tài khoản Google và cần đăng nhập để tạo và làm việc với các Dự án Firebase.
firebase_logout	core	Sử dụng để đăng xuất người dùng khỏi Firebase CLI và máy chủ Firebase MCP.
firebase_validate_security_rules	core	Sử dụng để kiểm tra các Quy tắc bảo mật Firebase cho Firestore, Storage hoặc Realtime Database để tìm lỗi cú pháp và xác thực.
firebase_get_project	core	Sử dụng để truy xuất thông tin về Dự án Firebase hiện đang hoạt động.
firebase_list_apps	core	Sử dụng để truy xuất danh sách các Ứng dụng Firebase đã đăng ký trong dự án Firebase hiện đang hoạt động. Ứng dụng Firebase có thể là iOS, Android hoặc Web.
firebase_list_projects	core	Sử dụng để truy xuất danh sách các Dự án Firebase mà người dùng đã đăng nhập có quyền truy cập.
firebase_get_sdk_config	core	Sử dụng để truy xuất thông tin cấu hình Firebase cho một Ứng dụng Firebase. Bạn phải chỉ định HOẶC một nền tảng HOẶC ID Ứng dụng Firebase cho một Ứng dụng Firebase đã đăng ký trong Dự án Firebase hiện đang hoạt động.
firebase_create_project	core	Sử dụng công cụ này để tạo một Dự án Firebase mới.
firebase_create_app	core	Sử dụng công cụ này để tạo một Ứng dụng Firebase mới trong Dự án Firebase hiện đang hoạt động. Ứng dụng Firebase có thể là iOS, Android hoặc Web.
firebase_create_android_sha	core	Sử dụng công cụ này để thêm hàm băm chứng chỉ SHA đã chỉ định vào Ứng dụng Firebase Android đã chỉ định.
firebase_get_environment	core	Sử dụng công cụ này để truy xuất cấu hình môi trường Firebase hiện tại cho Firebase CLI và máy chủ Firebase MCP, bao gồm người dùng đã xác thực hiện tại, thư mục dự án, Dự án Firebase đang hoạt động, v.v. Tất cả các công cụ đều yêu cầu người dùng phải được xác thực, nhưng không phải tất cả thông tin đều cần thiết cho mọi công cụ. Hãy chú ý đến các yêu cầu của công cụ về những thông tin nào là bắt buộc.
firebase_update_environment	core	Sử dụng công cụ này để cập nhật cấu hình môi trường cho Firebase CLI và máy chủ Firebase MCP, chẳng hạn như thư mục dự án, dự án đang hoạt động, tài khoản người dùng đang hoạt động, chấp nhận điều khoản dịch vụ, v.v. Sử dụng firebase_get_environment để xem môi trường hiện đang được cấu hình.
firebase_init	core	Sử dụng công cụ này để khởi tạo các dịch vụ Firebase đã chọn trong không gian làm việc (cơ sở dữ liệu Cloud Firestore, Firebase SQL Connect, Firebase Realtime Database, Firebase AI Logic). Tất cả các dịch vụ đều là tùy chọn; chỉ chỉ định những sản phẩm bạn muốn thiết lập. Bạn có thể khởi tạo các tính năng mới vào một thư mục dự án hiện có, nhưng việc khởi tạo lại một tính năng hiện có có thể ghi đè cấu hình. Để triển khai các tính năng đã khởi tạo, hãy chạy lệnh firebase deploy sau công cụ firebase_init.
firebase_get_security_rules	core	Sử dụng công cụ này để truy xuất các quy tắc bảo mật cho một dịch vụ Firebase đã chỉ định. Nếu có nhiều phiên bản của dịch vụ đó trong sản phẩm, các quy tắc cho phiên bản mặc định sẽ được trả về.
firebase_read_resources	core	Sử dụng công cụ này để đọc nội dung của các tài nguyên firebase:// hoặc liệt kê các tài nguyên có sẵn
crashlytics_create_note	crashlytics	Thêm ghi chú vào một sự cố từ Crashlytics.
crashlytics_delete_note	crashlytics	Xóa ghi chú khỏi một sự cố Crashlytics.
crashlytics_get_issue	crashlytics	Lấy dữ liệu cho một sự cố Crashlytics, có thể được sử dụng làm điểm khởi đầu để gỡ lỗi.
crashlytics_list_events	crashlytics	Sử dụng công cụ này để liệt kê các sự kiện gần đây nhất khớp với các bộ lọc đã cho. Có thể được sử dụng để tìm nạp các sự cố và ngoại lệ mẫu cho một sự cố, sẽ bao gồm dấu vết ngăn xếp và dữ liệu khác hữu ích cho việc gỡ lỗi.
crashlytics_batch_get_events	crashlytics	Lấy các sự kiện cụ thể theo tên tài nguyên. Có thể được sử dụng để tìm nạp các sự cố và ngoại lệ mẫu cho một sự cố, sẽ bao gồm dấu vết ngăn xếp và dữ liệu khác hữu ích cho việc gỡ lỗi.
crashlytics_list_notes	crashlytics	Sử dụng công cụ này để liệt kê tất cả các ghi chú cho một sự cố trong Crashlytics.
crashlytics_update_issue	crashlytics	Sử dụng công cụ này để cập nhật trạng thái của sự cố Crashlytics.
realtimedatabase_get_data	realtimedatabase	Sử dụng công cụ này để truy xuất dữ liệu từ vị trí được chỉ định trong Firebase Realtime Database.
realtimedatabase_set_data	realtimedatabase	Sử dụng công cụ này để ghi dữ liệu vào vị trí được chỉ định trong Firebase Realtime Database.
dataconnect_build	dataconnect	Sử dụng công cụ này để biên dịch lược đồ, thao tác và/hoặc trình kết nối Firebase SQL Connect và kiểm tra lỗi build.
dataconnect_list_services	dataconnect	Sử dụng công cụ này để liệt kê các dịch vụ Firebase SQL Connect cục bộ và backend hiện có.
dataconnect_execute	dataconnect	Sử dụng công cụ này để thực thi một thao tác GraphQL đối với dịch vụ SQL Connect hoặc trình giả lập của nó.
firestore_delete_document	firestore	Sử dụng công cụ này để xóa tài liệu Firestore khỏi cơ sở dữ liệu trong dự án hiện tại bằng đường dẫn tài liệu đầy đủ. Sử dụng nếu bạn biết đường dẫn chính xác của tài liệu.
firestore_get_documents	firestore	Sử dụng công cụ này để truy xuất một hoặc nhiều tài liệu Firestore từ cơ sở dữ liệu trong dự án hiện tại bằng đường dẫn tài liệu đầy đủ. Sử dụng nếu bạn biết đường dẫn chính xác của tài liệu.
firestore_list_collections	firestore	Sử dụng công cụ này để truy xuất danh sách các collection từ cơ sở dữ liệu Firestore trong dự án hiện tại.
firestore_query_collection	firestore	Sử dụng công cụ này để truy xuất một hoặc nhiều tài liệu Firestore từ một collection trong cơ sở dữ liệu của dự án hiện tại bằng một collection với đường dẫn tài liệu đầy đủ. Sử dụng nếu bạn biết đường dẫn chính xác của collection và mệnh đề lọc bạn muốn cho tài liệu.
functions_get_logs	functions	Sử dụng công cụ này để truy xuất một trang các mục nhật ký Cloud Functions bằng bộ lọc nâng cao của Google Cloud Logging.
functions_list_functions	functions	Liệt kê tất cả các function đã triển khai trong dự án Firebase của bạn.
messaging_send_message	messaging	Sử dụng công cụ này để gửi tin nhắn đến token đăng ký hoặc chủ đề Firebase Cloud Messaging. CHỈ MỘT TRONG registration_token hoặc topic có thể được cung cấp trong một lệnh gọi cụ thể.
remoteconfig_get_template	remoteconfig	Sử dụng để truy xuất mẫu Firebase Remote Config được chỉ định từ Dự án Firebase hiện đang hoạt động.
remoteconfig_update_template	remoteconfig	Sử dụng để xuất bản một mẫu remote config mới hoặc quay lại phiên bản cụ thể cho dự án
storage_get_object_download_url	storage	Sử dụng để truy xuất URL tải xuống cho một đối tượng trong bucket Cloud Storage for Firebase.
---------------------------------	-------------	-----------------------------------------------------------------------------------------------------------------------------------------------------------------
firebase:deploy	core	Sử dụng lệnh này để triển khai tài nguyên lên Firebase. Tham số: <prompt> (tùy chọn): bất kỳ hướng dẫn cụ thể nào bạn muốn cung cấp về việc triển khai
firebase:init	core	Sử dụng lệnh này để thiết lập các dịch vụ Firebase, như tính năng backend và AI.
firestore:generate_security_rules	firestore	Tạo Quy tắc Bảo mật Firebase Firestore an toàn và các bài kiểm thử đơn vị tương ứng cho dự án của bạn.
storage:generate_security_rules	storage	Tạo Quy tắc Bảo mật Firebase Storage an toàn và các bài kiểm thử đơn vị tương ứng cho dự án của bạn.
crashlytics:connect	crashlytics	Sử dụng lệnh này để truy cập dữ liệu Crashlytics của ứng dụng Firebase.

Tên Tài nguyên	Mô tả
app_id_guide	Hướng dẫn ID Ứng dụng Firebase: hướng dẫn tác nhân lập trình chọn ID Ứng dụng Firebase trong dự án hiện tại
crashlytics_investigations_guide	Hướng dẫn Điều tra Crashlytics Firebase: Hướng dẫn tác nhân lập trình khi điều tra lỗi được báo cáo trong các vấn đề Crashlytics, bao gồm quy trình chẩn đoán và sửa lỗi crash.
crashlytics_issues_guide	Hướng dẫn Vấn đề Crashlytics Firebase: Hướng dẫn tác nhân lập trình khi làm việc với các vấn đề Crashlytics, bao gồm quy tắc ưu tiên và quy trình chẩn đoán, sửa lỗi crash.
crashlytics_reports_guide	Hướng dẫn Báo cáo Crashlytics Firebase: Hướng dẫn tác nhân lập trình yêu cầu báo cáo Crashlytics, bao gồm thiết lập bộ lọc phù hợp và cách hiểu các chỉ số. Tác nhân nên đọc hướng dẫn này trước khi yêu cầu bất kỳ báo cáo nào.
backend_init_guide	Hướng dẫn Khởi tạo Backend Firebase: hướng dẫn tác nhân lập trình cấu hình các dịch vụ backend Firebase trong dự án hiện tại
ai_init_guide	Hướng dẫn Khởi tạo GenAI Firebase: hướng dẫn tác nhân lập trình cấu hình các khả năng GenAI trong dự án hiện tại sử dụng Firebase
firestore_init_guide	Hướng dẫn Khởi tạo Firestore: hướng dẫn tác nhân lập trình cấu hình Firestore trong dự án hiện tại
firestore_rules_init_guide	Hướng dẫn Khởi tạo Quy tắc Firestore: hướng dẫn tác nhân lập trình thiết lập quy tắc bảo mật Firestore trong dự án
auth_init_guide	Hướng dẫn Khởi tạo Xác thực Firebase: hướng dẫn tác nhân lập trình cấu hình Xác thực Firebase trong dự án hiện tại
hosting_init_guide	Hướng dẫn Triển khai Firebase Hosting: hướng dẫn tác nhân lập trình triển khai lên Firebase Hosting trong dự án hiện tại
docs	Tài liệu Firebase: tải nội dung văn bản thuần túy từ tài liệu Firebase, ví dụ: https://firebase.google.com/docs/functions trở thành firebase://docs/functions