Firestore Advanced MCP

Firestore高级MCP服务器，为大型语言模型如Claude提供与Firebase Firestore数据库全面交互的能力，支持CRUD、高级查询、事务处理等操作。

数据库开发者工具 #Firestore交互 #高级查询 #事务处理 #数据管理 .JavaScript

评分 : 2分

下载量 : 7.9K

更新时间 : 2025-04-28

打开站点

什么是Firestore Advanced MCP?

Firestore Advanced MCP是一个连接大型语言模型(如Claude)与Firebase Firestore数据库的中间件服务器。它实现了Model Context Protocol(MCP)协议，使AI能够执行复杂的数据库操作而无需直接访问数据库。

如何使用Firestore Advanced MCP?

只需安装服务器，配置Firebase服务账户，然后通过简单的JSON指令与数据库交互。服务器会处理所有技术细节，您只需关注业务逻辑。

适用场景

适用于需要AI助手管理数据库内容的场景，如自动数据录入、智能查询分析、定时数据清理等。特别适合非技术人员通过自然语言操作数据库。

主要功能

基础CRUD操作

完整的创建、读取、更新和删除文档功能

高级查询

支持复合查询、集合组查询和文档计数

特殊数据类型

处理地理位置、文档引用和时间戳等特殊类型

TTL管理

为文档设置自动过期时间

批量操作

原子性批量写入和事务支持

优势

无需编写代码即可通过自然语言操作数据库

完整支持Firestore所有高级功能

自动处理复杂的技术细节如索引管理

安全隔离，AI只能通过受控接口访问数据库

局限性

需要Node.js环境运行服务器

性能略低于直接数据库访问

复杂查询需要精确的JSON指令

如何使用

安装服务器

通过npm全局安装或从GitHub克隆

获取Firebase服务账户密钥

从Firebase控制台下载服务账户JSON文件

设置环境变量

指定服务账户密钥文件路径

启动服务器

运行服务器程序

配置Claude

在Claude配置文件中添加MCP服务器设置

使用案例

用户管理系统

通过自然语言管理用户数据

产品库存查询

智能查询库存产品

自动数据清理

设置临时数据的自动过期

常见问题

需要什么技术前提条件?

如何确保数据安全?

支持哪些Firestore功能?

性能如何?

🚀 Firestore高级MCP

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

🚀 快速开始

先决条件

安装 Node.js v14 或更高版本。
创建 Firebase 项目并获取 Firestore 数据库。
下载并配置 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
}