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

這是一種基於 Firebase 的 Model Context Protocol (MCP) 服務器实现，提供兩種運行模式：

1. 本地 Node.js 模式（使用 Firebase Admin SDK）
2. Cloudflare Workers 模式（使用 Firebase REST API）

功能

-Firestore 資料庫操作（讀取、寫入、更新、刪除文檔）
-集合和子集合的列表查詢
-支援過濾條件的查詢

必要條件

-Node.js 18 或更高版本
-Firebase 專案
-Firebase 服務帳號（用於本地模式）
-Firebase Web API 密鑰（用於 Cloudflare Workers 模式）

安裝

1. 克隆此專案：

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

2. 安裝依賴：

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

運行

本地模式（Firebase Admin SDK）

# 編譯 TypeScript 並運行服務器
npm run dev

或使用提供的腳本設置環境變量並運行：

# 互動式方式設置環境變量並啟動服務器
node src/index.ts

Cloudflare Workers 模式

cd workers  
npm install && npm run dev

使用方法

初始化專案

在根目錄執行：

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 許可證。