🔥 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

Related MCP server: MCP Firebase Server

📋 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

1. 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

2. 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 .