MCP Server Firebase

🚀 基於 Firebase 的 Model Context Protocol (MCP) 服務器

這是一個基於 Firebase 的 Model Context Protocol (MCP) 服務器實現，提供了兩種運行模式，能有效滿足不同場景下的使用需求。

• 本地 Node.js 模式：藉助 Firebase Admin SDK 運行。
• Cloudflare Workers 模式：通過 Firebase REST API 運行。

🚀 快速開始

本服務器提供了兩種運行模式，你可以根據自身需求選擇合適的模式來啟動服務。

✨ 主要特性

• Firestore 數據庫操作：支持對文檔進行讀取、寫入、更新和刪除操作。
• 集合和子集合查詢：可對集合和子集合進行列表查詢。
• 過濾條件查詢：支持帶有過濾條件的查詢。

📦 安裝指南

克隆項目

git clone https://github.com/[您的用戶名]/mcp-server-firebase.git
cd mcp-server-firebase

安裝依賴

npm install

🛠️ 配置說明

本地模式配置（Firebase Admin SDK）

1. 從 Firebase 控制檯下載服務賬號密鑰文件：
   • 前往 Firebase 控制檯 > 項目設置 > 服務賬號 > 生成新的私鑰。
2. 將下載的 JSON 文件保存到項目目錄中（文件名不重要，但請記住路徑）。
3. 設置環境變量：

export SERVICE_ACCOUNT_KEY_PATH="/path/to/your-service-account.json"

Cloudflare Workers 模式配置

1. 更新 wrangler.toml 文件中的環境變量：
   • FIREBASE_PROJECT_ID：您的 Firebase 項目 ID。
   • FIREBASE_API_KEY：您的 Firebase Web API 密鑰。
   • FIREBASE_AUTH_DOMAIN：通常是 [PROJECT_ID].firebaseapp.com。
2. 或者使用 Cloudflare Secrets 設置環境變量：

npx wrangler secret put FIREBASE_PROJECT_ID
npx wrangler secret put FIREBASE_API_KEY
npx wrangler secret put FIREBASE_AUTH_DOMAIN

💻 使用示例

初始化項目

在根目錄執行：

npm install mcp-server-firebase

啟動服務器（本地模式）

npm start

部署到 Cloudflare Pages

1. 在 wrangler.toml 中設置環境變量。
2. 執行：

npm run build && npm run deploy

⚠️ 重要提示

⚠️ 重要提示

• 請勿將服務賬號密鑰或 API 密鑰提交到 Git 存儲庫。
• 在部署前確保所有敏感信息已設置為環境變量或 Secrets。
• 為 Firestore 設置適當的安全規則。

💡 使用建議

• src/worker.ts 是 Cloudflare Workers 部署版本。
• src/index.ts 是本地運行版本。
• 請確保 Firebase 服務賬號具有適當的權限。

📄 許可證

此項目使用 MIT 許可證。