Firestore Advanced Mcp

🚀 Firestore高级MCP

Firestore高级MCP是一款强大的工具，支持对文档进行增删改查，提供自动索引和查询优化，还能实现实时数据同步，确保数据一致性。

🚀 快速开始

先决条件

1. 安装 Node.js v14 或更高版本。
2. 创建 Firebase 项目并获取 Firestore 数据库。
3. 下载并配置 Firebase 的 service account key。

安装

方式一：通过 npm 安装

npm install firebase @types/firebase firebase-admin

方式二：从源码安装

git clone https://github.com/FirebaseExtended/firestore-mcp.git
cd firestore-mcp
npm install

配置

在项目根目录创建 config.js 文件：

const firebaseConfig = {
apiKey: 'your-api-key',
authDomain: 'your-project-id.firebaseapp.com',
projectId: 'your-project-id',
storageBucket: 'your-storage-bucket.appspot.com',
messagingSenderId: 'your-messaging-sender-id',
appId: 'your-app-id'
};

initializeApp(firebaseConfig);

环境变量

设置以下环境变量：

• FIREBASE_API_KEY
• FIREBASE_AUTH_DOMAIN
• FIREBASE_PROJECT_ID
• FIREBASE_STORAGE_BUCKET
• FIREBASE_MESSAGING_SENDER_ID
• FIREBASE_APP_ID

使用

方式一：通过 npm

node index.js

方式二：通过 npx

npx firebase-mcp

方式三：直接运行脚本

const { initializeApp } = require('firebase-admin/app');
const { getFirestore } = require('firebase-admin/firestore');

const app = initializeApp();
const db = getFirestore(app);

在 Claude 中配置

在 claude-config.json 文件中添加：

{
"firestore": {
"apiKey": "your-api-key",
"authDomain": "your-project-id.firebaseapp.com",
"projectId": "your-project-id"
}
}

✨ 主要特性

• 🔥 支持对文档进行增删改查操作。
• 🛡️ 提供自动索引和查询优化功能。
• 🔄 支持实时数据同步，确保数据一致性。

📦 安装指南

方式一：通过 npm 安装

npm install firebase @types/firebase firebase-admin

方式二：从源码安装

git clone https://github.com/FirebaseExtended/firestore-mcp.git
cd firestore-mcp
npm install

💻 使用示例

基础用法

获取用户

{
"collection": "users",
"id": "user123"
}

创建订单

{
"collection": "orders",
"data": {
"product": "Laptop",
"price": 999.99,
"fields": [
{
"fieldPath": "user",
"type": "reference",
"value": "users/user123"
}
]
}
}

设置 TTL

{
"collection": "temporaryData",
"id": "session123",
"expiresIn": 86400000,
"fieldName": "expires_at"
}

高级用法

多条件查询

{
"collection": "products",
"filters": [
{
"field": "category",
"operator": "==",
"value": "electronics"
},
{
"field": "price",
"operator": "<",
"value": 1000
}
],
"orderBy": {
"field": "price",
"direction": "asc"
},
"limit": 10
}

📚 详细文档

如需了解更多信息，请参考：

• Firestore 文档
• MCP 协议文档

📄 许可证

此项目使用 MIT 许可证，查看文件 LICENSE 以获取详细信息。

作者

• Diez7lm

致谢

感谢以下组织和项目的贡献：

• Anthropic 提供 Claude 和 MCP 协议。
• Firebase 提供 Firestore 和开发工具。

贡献

欢迎任何贡献！请随时通过 GitHub 提交拉取请求或问题，以改进此项目。