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 công cụ khác!

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ể tận dụng khả năng AI của nó để giúp bạn:

• Tạo và quản lý các 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ý các ứ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ý các 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ự hỗ trợ 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 bằng 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 in 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 in Firebase có thể tạo ra kết quả 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. Xác thực tất cả kết quả từ Gemini trước khi sử dụng và không sử dụng mã được tạo chưa qua kiểm tra trong môi trường sản xuất. 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 in 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 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 Firebase extension 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 Firebase marketplace 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"]
    }
  }
}

Cách 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 hỗ trợ 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!

Để có danh sách đầy đủ các công cụ và tài nguyên có sẵn, hãy xem phần Server Capabilities 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.

Server Capabilities

Firebase MCP server cung cấp ba loại khả năng: Tools (các hàm thực hiện hành động), Prompts (các mẫu lệnh tái sử dụng) và Resources (các 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	Lấy nhật ký dịch vụ hoặc bản dựng gần đây cho một backend App Hosting.
apphosting_list_backends	apphosting	Liệt kê các backend App Hosting, cấu hình lưu lượng truy cập và tên miền tùy chỉnh trong dự án của bạn.
auth_get_users	auth	Truy xuất người dùng Firebase Auth theo UID, email, số điện thoại hoặc liệt kê tất cả người dùng.
auth_update_user	auth	Cập nhật tài khoản của người dùng bằng cách bật/tắt tài khoản hoặc đặt các claims tùy chỉnh.
auth_set_sms_region_policy	auth	Đặt chính sách vùng SMS cho phép hoặc từ chối các mã quốc gia cụ thể cho Firebase Authentication.
firebase_login	core	Đăng nhập người dùng vào Firebase CLI và máy chủ MCP hoặc kiểm tra trạng thái xác thực hiện tại.
firebase_logout	core	Đăng xuất người dùng khỏi Firebase CLI và máy chủ MCP.
firebase_validate_security_rules	core	Xác thực cú pháp và kiểm tra lỗi trong các quy tắc bảo mật của Firestore, Storage hoặc Realtime Database.
firebase_get_project	core	Truy xuất siêu dữ liệu và chi tiết cấu hình cho dự án Firebase đang hoạt động hiện tại.
firebase_list_apps	core	Liệt kê tất cả ứng dụng Firebase đã đăng ký trong dự án đang hoạt động.
firebase_list_projects	core	Liệt kê các dự án Firebase mà người dùng đã xác thực có thể truy cập.
firebase_get_sdk_config	core	Truy xuất chi tiết cấu hình SDK hoặc nội dung tệp cấu hình cho một ứng dụng Firebase đã đăng ký.
firebase_create_project	core	Tạo một dự án Firebase mới hoặc bật các dịch vụ Firebase trên một dự án Google Cloud hiện có.
firebase_create_app	core	Tạo một ứng dụng iOS, Android hoặc Web mới trong dự án Firebase đang hoạt động.
firebase_create_android_sha	core	Thêm hàm băm chứng chỉ SHA-1 hoặc SHA-256 vào một ứng dụng Android trong dự án Firebase đang hoạt động.
firebase_get_environment	core	Truy xuất cấu hình môi trường Firebase CLI và MCP hiện tại, dự án đang hoạt động và người dùng đã xác thực.
firebase_update_environment	core	Cập nhật cài đặt môi trường như thư mục dự án, dự án đang hoạt động hoặc tài khoản người dùng đang hoạt động.
firebase_init	core	Khởi tạo và cấu hình các dịch vụ Firebase trong không gian làm việc dự án cục bộ của bạn.
firebase_get_security_rules	core	Truy xuất các quy tắc bảo mật đang hoạt động cho Firestore, Storage hoặc Realtime Database.
firebase_read_resources	core	Đọc nội dung của các tài nguyên tài liệu nội bộ firebase:// hoặc liệt kê tất cả các tài nguyên có sẵn.
crashlytics_create_note	crashlytics	Thêm ghi chú vào một sự cố Crashlytics cho ứng dụng Android hoặc iOS.
crashlytics_delete_note	crashlytics	Xóa ghi chú khỏi một sự cố Crashlytics cho ứng dụng Android hoặc iOS.
crashlytics_get_issue	crashlytics	Truy xuất chi tiết và siêu dữ liệu cho một sự cố Crashlytics cụ thể.
crashlytics_list_events	crashlytics	Liệt kê các sự kiện sự cố và ngoại lệ gần đây khớp với các bộ lọc đã chỉ định cho một sự cố.
crashlytics_batch_get_events	crashlytics	Truy xuất các sự kiện sự cố và ngoại lệ mẫu theo tên tài nguyên để gỡ lỗi.
crashlytics_list_notes	crashlytics	Liệt kê tất cả ghi chú đính kèm vào một sự cố Crashlytics cho ứng dụng Android hoặc iOS.
crashlytics_get_report	crashlytics	Tạo báo cáo số tổng hợp cho các sự cố và sự kiện Crashlytics.
crashlytics_update_issue	crashlytics	Cập nhật trạng thái (OPEN hoặc CLOSED) của một sự cố Crashlytics.
realtimedatabase_get_data	realtimedatabase	Đọc dữ liệu từ một đường dẫn cụ thể trong Firebase Realtime Database.
realtimedatabase_set_data	realtimedatabase	Ghi dữ liệu JSON vào một đường dẫn cụ thể trong Firebase Realtime Database.
dataconnect_build	dataconnect	Biên dịch các lược đồ, thao tác và trình kết nối Firebase SQL Connect để xác thực cú pháp và kiểu dữ liệu.
dataconnect_list_services	dataconnect	Liệt kê các dịch vụ, lược đồ và trình kết nối Firebase SQL Connect cục bộ và đã triển khai.
dataconnect_execute	dataconnect	Thực thi một truy vấn hoặc thay đổi GraphQL đối với một dịch vụ hoặc trình mô phỏng Firebase SQL Connect.
firestore_delete_document	firestore	Sử dụng công cụ này để xóa các tài liệu Firestore khỏi cơ sở dữ liệu trong dự án hiện tại theo đường dẫn tài liệu đầy đủ. Sử dụng công cụ này nếu bạn biết đường dẫn chính xác của một 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 theo đường dẫn tài liệu đầy đủ. Sử dụng công cụ này nếu bạn biết đường dẫn chính xác của một tài liệu.
firestore_list_collections	firestore	Sử dụng công cụ này để truy xuất danh sách các bộ sưu tập từ cơ sở dữ liệu Firestore trong dự án hiện tại.
firestore_query_collection	firestore	Truy vấn các tài liệu Firestore từ một bộ sưu tập với các bộ lọc và thứ tự tùy chọn.
functions_get_logs	functions	Truy xuất và lọc các mục nhật ký Cloud Functions từ Google Cloud Logging.
functions_list_functions	functions	Liệt kê tất cả Cloud Functions đã triển khai trong dự án Firebase của bạn.
messaging_send_message	messaging	Gửi thông báo đẩy Firebase Cloud Messaging đến mã thông báo đăng ký thiết bị hoặc chủ đề.
remoteconfig_get_template	remoteconfig	Truy xuất phiên bản đang hoạt động hoặc phiên bản đã chỉ định của mẫu Firebase Remote Config.
remoteconfig_update_template	remoteconfig	Xuất bản mẫu Firebase Remote Config mới hoặc khôi phục về phiên bản trước đó.
storage_get_object_download_url	storage	Truy xuất URL tải xuống cho một đối tượng trong nhóm Cloud Storage.

Tên Lời Nhắc	Nhóm Tính Năng	Mô Tả
firebase:deploy	core	Sử dụng lệnh này để triển khai tài nguyên lên Firebase. Đối 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 Firebase Firestore Security Rules an toàn và các bài kiểm tra đơn vị tương ứng cho dự án của bạn.
storage:generate_security_rules	storage	Tạo Firebase Storage Security Rules an toàn và các bài kiểm tra đơ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 một ứng dụng Firebase.
Tên tài nguyên	Mô tả
--------------------------------	-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
app_id_guide	Hướng dẫn Firebase App Id: hướng dẫn tác nhân lập trình chọn Firebase App ID trong dự án hiện tại
crashlytics_investigations_guide	Hướng dẫn điều tra Firebase Crashlytics: 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 các quy trình chẩn đoán và sửa lỗi.
crashlytics_issues_guide	Hướng dẫn vấn đề Firebase Crashlytics: 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 các quy tắc ưu tiên và quy trình chẩn đoán cũng như sửa lỗi.
crashlytics_reports_guide	Hướng dẫn báo cáo Firebase Crashlytics: 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 Firebase Backend: 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 Firebase GenAI: 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 các quy tắc bảo mật Firestore trong dự án
auth_init_guide	Hướng dẫn khởi tạo Firebase Authentication: hướng dẫn tác nhân lập trình cấu hình Firebase Authentication 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