Máy chủ MCP Firebase

Máy chủ MCP Firebase 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ụ cho nhà 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ủ MCP của Firebase hoạt động với mọi công cụ có thể đóng vai trò là ứng dụng MCP, bao gồm: Antigravity, Claude Code và Claude Desktop, Cline, Cursor, VS Code Copilot, Windsurf, v.v.!

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ể dùng các chức năng AI của máy chủ đó để giúp bạn:

• Tạo và quản lý dự án Firebase
• Quản lý người dùng Firebase Authentication
• Xử lý 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 khả năng của máy chủ để biết danh sách đầy đủ các công cụ có sẵn cho trình chỉnh sửa của bạn.

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

Máy chủ MCP của Firebase 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ủ MCP của Firebase thực hiện 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ù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 xác thực 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 rằng bạn đã cài đặt Node.js và npm.

Cấu hình cơ bản

Dưới đây là hướng dẫn cấu hình cơ bản để 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 từng ứng dụng (đã trình bày ở trên), bạn có thể chỉ định hai tham 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 cung cấp 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ác nhóm tính năng cần kích hoạt, được phân tách bằng dấu phẩy. Hãy sử dụng chế độ này để giới hạn các công cụ hiển thị chỉ cho những tính năng 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ủ MCP của Firebase cung cấp 3 danh mục tính năng MCP:

• Câu lệnh: Thư viện câu lệnh 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 ứ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, giúp các tác nhân này làm việc trực tiếp với dự án Firebase của bạn (sau khi bạn phê duyệt!)

• Tài nguyên: Các tệp tài liệu dành cho tác nhân AI để cung cấp thêm hướng dẫn và bối cảnh giúp tác nhân 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 câu lệnh viết sẵn được tối ưu hoá để phát triển và chạy ứ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 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ụ cho nhà 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 hiện có.

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, giúp các tác nhân này làm việc trực tiếp với dự án Firebase của bạn (với sự chấp thuận 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ợ 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 nhiệm 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 tài nguyên, là các tệp tài liệu dành cho các tác nhân AI sử dụng. Các 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 bối cảnh của 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