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.

Integrations

Provides comprehensive access to Firestore databases, enabling CRUD operations, complex queries with multiple filters, transactions, batch operations, special data types handling, TTL management, and advanced search capabilities across collections.

🔥 MCP avanzado de Firestore

Servidor MCP (Protocolo de contexto de modelo) avanzado para Firebase Firestore, que permite que modelos de lenguaje grandes como Claude interactúen completamente con sus bases de datos de Firebase.

✨ Características

📝 Compatibilidad completa con Firestore : CRUD, consultas compuestas, filtros múltiples
⚡ Operaciones avanzadas : Transacciones, operaciones atómicas, actualizaciones por lotes
🔄 Tipos de datos especiales : GeoPoint, referencias de documentos, marcas de tiempo
⏱️ Gestión de TTL : Configuración del tiempo de vida de los documentos
🔍 Detección inteligente de índices faltantes : instrucciones automáticas para crear los índices necesarios
🎯 Búsqueda avanzada : Consultas sobre grupos de colecciones, filtros complejos

📋 Requisitos previos

Node.js >= 16.0.0
Un proyecto de Firebase con Firestore habilitado
Una clave de cuenta de servicio de Firebase (archivo JSON)

🚀 Instalación

A través de npm

npm install -g firestore-advanced-mcp

A través de GitHub

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

🔧 Configuración

Obtén tu clave de cuenta de servicio de Firebase :
- Vaya a la consola de Firebase
- Seleccione su proyecto
- Configuración del proyecto > Cuentas de servicio
- Generar una nueva clave privada y cargar el archivo JSON
Establezca la variable de entorno :

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

🖥️Usar

Con npm global

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

Con npx

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

Desde el directorio clonado

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

Configuración en Claude

Para utilizar este servidor MCP con Claude, agregue la siguiente configuración a su archivo claude_desktop_config.json :

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

O para una versión instalada localmente:

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

🛠️ Herramientas disponibles

El servidor proporciona las siguientes herramientas a Claude:

Operaciones básicas

firestore_get - Recuperar un documento
firestore_create - Crea un nuevo documento
firestore_update - Actualizar un documento existente
firestore_delete - Eliminar un documento
firestore_query - Ejecutar una consulta con filtros
firestore_list_collections - Lista de colecciones disponibles

Consultas avanzadas

firestore_collection_group_query - Consulta de grupo de colecciones
firestore_composite_query : consulta con múltiples filtros y ordenaciones
firestore_count_documents - Cuenta documentos sin recuperar todo

Tipos especiales y funciones avanzadas

firestore_special_data_types - Administrar puntos geográficos y referencias
firestore_set_ttl - Configurar la expiración automática de documentos
firestore_transaction - Ejecuta una transacción que consta de múltiples operaciones
firestore_batch - Ejecutar operaciones por lotes
firestore_field_operations - Operaciones atómicas (incremento, arrayUnion, etc.)
firestore_full_text_search - Búsqueda de texto completo en documentos

📝 Ejemplos

Recuperar un documento

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

Crear un documento con referencia a otro documento

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

Configurar TTL en un documento

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

Ejecutar una consulta con múltiples filtros

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

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

👨🏽‍💻 Autor

Diez7lm

🙏 Agradecimientos

Antrópico para Claude y el Protocolo de Contexto Modelo
Firebase para Firestore y herramientas para desarrolladores

🦾 Contribución

¡Las contribuciones son bienvenidas! No dudes en enviar una solicitud de extracción o informar problemas a través de los problemas de GitHub.

📚 Documentación adicional

Para obtener más información sobre el uso de Firestore con Firebase, consulte la documentación oficial de Firebase .

Para obtener más información sobre el Protocolo de contexto de modelo (MCP) y su uso con Claude, consulte la documentación de Anthropic .

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite que modelos de lenguaje grandes como Claude realicen interacciones integrales con las bases de datos de Firebase Firestore, admitiendo operaciones CRUD completas, consultas complejas y funciones avanzadas como transacciones y administración de TTL.

Appeared in Searches

Creating a database of novels and screenplays in Google Drive