Máy chủ MCP Firebase

Máy chủ Firebase MCP là một máy chủ Giao thức ngữ cảnh mô hình (MCP) cục bộ chạy trong môi trường phát triển của bạn để cung cấp cho các công cụ phát triển dựa trên AI khả năng làm việc với các dự án Firebase và toàn bộ mã nguồn của ứng dụng.

Máy chủ Firebase MCP hoạt động với mọi công cụ có thể đóng vai trò là một ứng dụng MCP, bao gồm: Antigravity, Claude Code và Claude Desktop, Cline, Cursor, VS Code Copilot, Windsurf và nhiều công cụ khác!

arrow_downward Chuyển đến hướng dẫn thiết lập

Lợi ích của máy chủ MCP

Một trình chỉnh sửa được định cấu hình để sử dụng máy chủ MCP của Firebase có thể sử dụng các chức năng AI của máy chủ này để giúp bạn:

• Tạo và quản lý dự án Firebase
• Quản lý người dùng Firebase Authentication
• Làm việc với dữ liệu trong Cloud Firestore và Firebase SQL Connect
• Truy xuất giản đồ Firebase SQL Connect
• Tìm hiểu các quy tắc bảo mật cho Cloud Firestore và Cloud Storage for Firebase
• Gửi tin nhắn bằng Firebase Cloud Messaging

Đây chỉ là danh sách một phần; hãy xem phần các chức năng của máy chủ để biết danh sách đầy đủ các công cụ mà trình chỉnh sửa của bạn có thể sử dụng.

Thiết lập ứng dụng MCP

Máy chủ Firebase MCP là một máy chủ MCP cục bộ có thể hoạt động với mọi ứng dụng MCP hỗ trợ I/O tiêu chuẩn (stdio) làm phương tiện truyền tải.

Khi máy chủ Firebase MCP thực hiện các lệnh gọi công cụ, máy chủ này sẽ chạy cục bộ trong môi trường của bạn bằng cách sử dụng cùng thông tin đăng nhập của người dùng để uỷ quyền cho Firebase CLI. Đây có thể là người dùng đã đăng nhập hoặc Thông tin đăng nhập mặc định của ứng dụng, tuỳ thuộc vào môi trường.

Trước khi bắt đầu

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

Cấu hình cơ bản

Sau đây là hướng dẫn cơ bản về cách định cấu hình để sử dụng máy chủ MCP của Firebase với một số công cụ hỗ trợ AI phổ biến:

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

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

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

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

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

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

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

Cấu hình không bắt buộc

Ngoài cấu hình cơ bản cho mỗi ứng dụng khách (như đã trình bày ở trên), bạn có thể chỉ định 2 thông số không bắt buộc:

• --dir ABSOLUTE_DIR_PATH: Đường dẫn tuyệt đối của một thư mục chứa firebase.json, để đặt bối cảnh dự án cho máy chủ MCP. Nếu bạn không chỉ định, các công cụ get_project_directory và set_project_directory sẽ có sẵn và thư mục mặc định sẽ là thư mục đang hoạt động nơi máy chủ MCP được khởi động.

• --only FEATURE_1,FEATURE_2: Danh sách được phân tách bằng dấu phẩy gồm các nhóm tính năng cần kích hoạt. Sử dụng chế độ này để giới hạn các công cụ chỉ ở những tính năng mà bạn đang sử dụng. Xin lưu ý rằng các công cụ cốt lõi luôn có sẵn.

Ví dụ:

"firebase": {
  "command": "npx",
  "args": [
    "-y",
    "firebase-tools@latest", "mcp",
    "--dir", "/Users/turing/my-project",
    "--only", "auth,firestore,storage"
  ]
}

Các chức năng của máy chủ MCP

Máy chủ Firebase MCP cung cấp 3 danh mục tính năng MCP:

• Câu lệnh: Một thư viện gồm các câu lệnh được viết sẵn mà bạn có thể chạy; các câu lệnh này được tối ưu hoá để phát triển và chạy một ứng dụng bằng Firebase

• Công cụ: Một bộ công cụ dành cho các tác nhân AI sử dụng để giúp chúng hoạt động trực tiếp với dự án Firebase của bạn (với sự phê duyệt của bạn!)

• Tài nguyên: Tệp tài liệu dành cho các tác nhân AI sử dụng để cung cấp thêm hướng dẫn và bối cảnh cho các tác nhân này hoàn thành một nhiệm vụ hoặc mục tiêu

Câu lệnh

Máy chủ Firebase MCP đi kèm với một thư viện gồm các câu lệnh được viết sẵn và tối ưu hoá để phát triển và chạy một ứng dụng bằng Firebase. Bạn có thể sử dụng những câu lệnh này để hoàn thành nhiều nhiệm vụ hoặc mục tiêu phổ biến bằng các trợ lý AI tác nhân.

Bảng sau đây mô tả các câu lệnh mà máy chủ MCP cung cấp.

Nhiều công cụ phát triển hỗ trợ MCP cung cấp một cách thuận tiện để chạy các câu lệnh này. Ví dụ: dưới dạng lệnh dấu gạch chéo:

/firebase:init

Trong các môi trường được hỗ trợ, bạn có thể bắt đầu nhập /firebase: để xem danh sách các câu lệnh có sẵn.

npx firebase-tools@latest mcp --generate-prompt-list

Công cụ

Máy chủ MCP của Firebase cũng cung cấp một số công cụ dành cho các tác nhân AI sử dụng để giúp họ làm việc trực tiếp với dự án Firebase của bạn (với sự phê duyệt của bạn!). Không giống như câu lệnh, bạn không gọi trực tiếp các công cụ này; thay vào đó, các tác nhân AI hỗ trợ tính năng gọi công cụ (chẳng hạn như Antigravity, Claude Code hoặc Cursor) có thể tự động gọi các công cụ này để thực hiện các tác vụ phát triển khi cần.

Bảng sau đây mô tả các công cụ mà máy chủ MCP cung cấp.

npx firebase-tools@latest mcp --generate-tool-list

{
  "parent": "projects/my-project/databases/(default)/documents",
  "structured_aggregation_query": {
    "structured_query": {
      "from": [{"collection_id": "orders"}],
      "where": {
        "field_filter": {
          "field": {"field_path": "status"},
          "op": "EQUAL",
          "value": {"string_value": "COMPLETED"}
        }
      }
    },
    "aggregations": [
      {
        "alias": "total_orders",
        "count": {}
      },
      {
        "alias": "average_amount",
        "avg": {
          "field": {"field_path": "amount"}
        }
      }
    ]
  }
}

Tài nguyên

Máy chủ MCP cung cấp các tài nguyên là những tệp tài liệu dành cho các tác nhân AI sử dụng. Những tác nhân hỗ trợ việc sử dụng tài nguyên sẽ tự động đưa các tài nguyên có liên quan vào ngữ cảnh phiên.

Bảng sau đây mô tả các tài nguyên mà máy chủ MCP cung cấp.

npx firebase-tools@latest mcp --generate-resource-list