🚀 🔥 Firestore高级MCP

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

🚀 快速开始

在使用 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

💻 使用示例

基础用法

通过 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"
  }
}

功能示例

获取用户

{
  "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 提交拉取请求或问题，以改进此项目。