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 许可证。