Firestore Advanced MCP

🔥 Firestore Advanced MCP

Version License Node

Serveur MCP (Model Context Protocol) avancé pour Firebase Firestore, permettant aux grands modèles de langage comme Claude d'interagir de façon complète avec vos bases de données Firebase.

✨ Fonctionnalités

📝 Support complet de Firestore : CRUD, requêtes composées, filtres multiples
⚡ Opérations avancées : Transactions, opérations atomiques, mise à jour par lot
🔄 Types de données spéciaux : GeoPoint, références de documents, horodatages
⏱️ Gestion TTL : Configuration du Time-To-Live pour les documents
🔍 Détection intelligente des index manquants : Instructions automatiques pour créer les index nécessaires
🎯 Recherche avancée : Requêtes sur groupes de collections, filtres complexes

📋 Prérequis

Node.js >= 16.0.0
Un projet Firebase avec Firestore activé
Une clé de compte de service Firebase (fichier JSON)

🚀 Installation

Via npm

npm install -g firestore-advanced-mcp

Via GitHub

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

🔧 Configuration

Obtenir votre clé de compte de service Firebase :
- Allez sur la console Firebase
- Sélectionnez votre projet
- Paramètres du projet > Comptes de service
- Générez une nouvelle clé privée et téléchargez le fichier JSON
Définir la variable d'environnement :

export SERVICE_ACCOUNT_KEY_PATH="/chemin/vers/votre/serviceAccountKey.json"

🖥️ Utilisation

Avec npm global

SERVICE_ACCOUNT_KEY_PATH="/chemin/vers/votre/serviceAccountKey.json" firestore-advanced-mcp

Avec npx

SERVICE_ACCOUNT_KEY_PATH="/chemin/vers/votre/serviceAccountKey.json" npx firestore-advanced-mcp

Depuis le répertoire cloné

SERVICE_ACCOUNT_KEY_PATH="/chemin/vers/votre/serviceAccountKey.json" node index.js

Configuration dans Claude

Pour utiliser ce serveur MCP avec Claude, ajoutez la configuration suivante dans votre fichier claude_desktop_config.json :

"firebase-mcp": {
  "command": "npx",
  "args": ["firestore-advanced-mcp"],
  "env": {
    "SERVICE_ACCOUNT_KEY_PATH": "/chemin/vers/votre/serviceAccountKey.json"
  }
}

Ou pour une version installée localement :

"firebase-mcp": {
  "command": "node",
  "args": ["/chemin/vers/firestore-advanced-mcp/index.js"],
  "env": {
    "SERVICE_ACCOUNT_KEY_PATH": "/chemin/vers/votre/serviceAccountKey.json"
  }
}

🛠️ Outils disponibles

Le serveur fournit les outils suivants à Claude :

Opérations de base

firestore_get - Récupérer un document
firestore_create - Créer un nouveau document
firestore_update - Mettre à jour un document existant
firestore_delete - Supprimer un document
firestore_query - Exécuter une requête avec filtres
firestore_list_collections - Lister les collections disponibles

Requêtes avancées

firestore_collection_group_query - Requête sur groupes de collections
firestore_composite_query - Requête avec filtres et tris multiples
firestore_count_documents - Compter les documents sans tout récupérer

Types spéciaux et fonctionnalités avancées

firestore_special_data_types - Gérer les GeoPoints et références
firestore_set_ttl - Configurer l'expiration automatique des documents
firestore_transaction - Exécuter une transaction composée de multiples opérations
firestore_batch - Exécuter des opérations par lot
firestore_field_operations - Opérations atomiques (increment, arrayUnion, etc.)
firestore_full_text_search - Recherche textuelle dans les documents

📝 Exemples

Récupérer un document

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

Créer un document avec référence à un autre document

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

Configurer TTL sur un document

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

Exécuter une requête avec filtres multiples

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

📄 Licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.

👨🏽‍💻 Auteur

Diez7lm

🙏 Remerciements

Anthropic pour Claude et le Model Context Protocol
Firebase pour Firestore et les outils de développement

🦾 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à soumettre une pull request ou à signaler des problèmes via les issues GitHub.

📚 Documentation supplémentaire

Pour plus d'informations sur l'utilisation de Firestore avec Firebase, consultez la documentation officielle de Firebase.

Pour en savoir plus sur le Model Context Protocol (MCP) et son utilisation avec Claude, consultez la documentation d'Anthropic.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enables large language models like Claude to perform comprehensive interactions with Firebase Firestore databases, supporting full CRUD operations, complex queries, and advanced features like transactions and TTL management.

Related MCP Servers

MCP JSON Document Collection Server
jimpick
A
security
F
license
A
quality
A Model Context Protocol server that allows creation and management of multiple Fireproof JSON databases with CRUD operations, querying capabilities, and cloud synchronization for sharing databases with others.
Last updated -
9
2
JavaScript
ClickHouse MCP Server
ThomAub
-
security
A
license
-
quality
A Model Context Protocol server that enables Large Language Models to seamlessly interact with ClickHouse databases, supporting resource listing, schema retrieval, and query execution.
Last updated -
1
Python
MIT License
Astra DB MCP Serverofficial
datastax
A
security
A
license
A
quality
A Model Context Protocol server that allows Large Language Models to interact with Astra DB databases, providing tools for managing collections and records through natural language commands.
Last updated -
10
115
12
TypeScript
Apache 2.0
MCP TapData Serverofficial
tapdata
-
security
F
license
-
quality
A Model Context Protocol server that enables Large Language Models to access and interact with database connections, including viewing schemas and performing CRUD operations on connected databases.
Last updated -

View all related MCP servers

Firestore Advanced MCP