MCP 服务器

Firestore Advanced MCP

一个模型上下文协议服务器，使像 Claude 这样的大型语言模型能够与 Firebase Firestore 数据库进行全面的交互，支持完整的 CRUD 操作、复杂的查询以及诸如事务和 TTL 管理等高级功能。

README

🔥 Firestore 高级 MCP

用于 Firebase Firestore 的高级 MCP（模型上下文协议）服务器，允许像 Claude 这样的大型语言模型与您的 Firebase 数据库进行全面交互。

✨ 功能

📝 完整的 Firestore 支持：CRUD、复合查询、多重过滤器
⚡ 高级操作：事务、原子操作、批量更新
🔄 特殊数据类型：GeoPoint、文档引用、时间戳
⏱️ TTL 管理：配置文档的 Time-To-Live（生存时间）
🔍 智能检测缺失索引：自动生成创建所需索引的指令
🎯 高级搜索：集合组查询、复杂过滤器

📋 前提条件

Node.js >= 16.0.0
启用了 Firestore 的 Firebase 项目
Firebase 服务帐户密钥（JSON 文件）

🚀 安装

通过 npm

npm install -g firestore-advanced-mcp

通过 GitHub

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

🔧 配置

获取您的 Firebase 服务帐户密钥：
- 前往 Firebase 控制台
- 选择您的项目
- 项目设置 > 服务帐户
- 生成一个新的私钥并下载 JSON 文件
设置环境变量：

export SERVICE_ACCOUNT_KEY_PATH="/path/to/your/serviceAccountKey.json"

🖥️ 使用

使用全局 npm

SERVICE_ACCOUNT_KEY_PATH="/path/to/your/serviceAccountKey.json" firestore-advanced-mcp

使用 npx

SERVICE_ACCOUNT_KEY_PATH="/path/to/your/serviceAccountKey.json" npx firestore-advanced-mcp

从克隆的目录

SERVICE_ACCOUNT_KEY_PATH="/path/to/your/serviceAccountKey.json" node index.js

在 Claude 中配置

要将此 MCP 服务器与 Claude 一起使用，请将以下配置添加到您的 claude_desktop_config.json 文件中：

"firebase-mcp": {
  "command": "npx",
  "args": ["firestore-advanced-mcp"],
  "env": {
    "SERVICE_ACCOUNT_KEY_PATH": "/path/to/your/serviceAccountKey.json"
  }
}

或者对于本地安装的版本：

"firebase-mcp": {
  "command": "node",
  "args": ["/path/to/firestore-advanced-mcp/index.js"],
  "env": {
    "SERVICE_ACCOUNT_KEY_PATH": "/path/to/your/serviceAccountKey.json"
  }
}

🛠️ 可用工具

服务器为 Claude 提供以下工具：

基本操作

firestore_get - 获取一个文档
firestore_create - 创建一个新文档
firestore_update - 更新一个现有文档
firestore_delete - 删除一个文档
firestore_query - 执行带有过滤器的查询
firestore_list_collections - 列出可用的集合

高级查询

firestore_collection_group_query - 集合组查询
firestore_composite_query - 带有多个过滤器和排序的查询
firestore_count_documents - 计算文档数量，无需全部检索

特殊类型和高级功能

firestore_special_data_types - 管理 GeoPoints 和引用
firestore_set_ttl - 配置文档的自动过期
firestore_transaction - 执行由多个操作组成的事务
firestore_batch - 执行批量操作
firestore_field_operations - 原子操作（increment、arrayUnion 等）
firestore_full_text_search - 在文档中进行全文搜索

📝 示例

获取一个文档

{
  "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
}