MCP Server Firebase

基本能力

产品定位

mcp-server-firebase 是一个基于 Firebase 的 MCP 服务器实现，主要用于操作 Firestore 数据库。

核心功能

• Firestore 数据库操作（读取、写入、更新、删除文档）
• 集合和子集合的列表查询
• 支持过滤条件的查询

适用场景

• 需要与 Firebase 数据库交互的应用
• 需要在本地或 Cloudflare Workers 环境中操作 Firestore 数据库的场景

工具列表

• mcp_firebase_mcp_firestore_add_document: 添加文档
• mcp_firebase_mcp_firestore_get_document: 获取文档
• mcp_firebase_mcp_firestore_update_document: 更新文档
• mcp_firebase_mcp_firestore_delete_document: 删除文档
• mcp_firebase_mcp_firestore_list_documents: 列出集合中的文档
• mcp_firebase_mcp_firestore_list_collections: 列出集合

常见问题解答

• 如何配置本地模式？ 从 Firebase 控制台下载服务账号密钥文件，并设置环境变量 SERVICE_ACCOUNT_KEY_PATH。
• 如何配置 Cloudflare Workers 模式？ 更新 wrangler.toml 文件中的环境变量或使用 Cloudflare Secrets 设置环境变量。
• 如何确保安全？ 不要将服务账号密钥或 API 密钥提交到 Git 存储库，确保所有敏感信息已设置为环境变量或 Secrets。

使用教程

使用依赖

• Node.js 18 或更高版本
• Firebase 项目
• Firebase 服务账号（用于本地模式）
• Firebase Web API 密钥（用于 Cloudflare Workers 模式）

安装教程

1. 克隆项目:

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

1. 安装依赖:

npm install

调试方式

本地模式 (Firebase Admin SDK)

npm run dev

或使用提供的脚本设置环境变量并运行:

node setup-firebase-env.js

Cloudflare Workers 模式 (本地开发)

npm run dev:worker

同时运行两种模式

npm run dev:all

部署

部署到 Cloudflare Workers

npm run deploy:worker
npm run deploy:production

许可证

该项目遵循 MIT 开源许可条款。