Servidor MCP de Firestore

Un servidor MCP (Protocolo de Contexto de Modelo) para interactuar directamente con Google Firestore. Este servidor proporciona una interfaz sencilla para crear, leer, actualizar y eliminar documentos de Firestore a través de Claude Desktop.

Características

• Crear documentos en colecciones de Firestore

• Leer documentos de las colecciones de Firestore

• Actualizar documentos existentes

• Eliminar documentos

• Consultar documentos con filtrado, ordenamiento y límites

• Lista de colecciones disponibles

Configuración

1. Instalar dependencias :

   npm install

2. Construir el proyecto :

   npm run build

3. Configurar Claude Desktop : agregue lo siguiente a su claude_desktop_config.json :

   "firestore-mcp": { "command": "node", "args": [ "/path/to/firestore-mcp/build/index.js" ], "env": { "GOOGLE_CLOUD_PROJECTS": "project-id" } }

   Reemplace la ruta en args con la ruta real a index.js.

   Define una lista de ID de proyecto separados por comas en GOOGLE_CLOUD_PROJECTS. Ejemplo: google-project-id1,google-project-id2 El primer proyecto de la lista es el predeterminado.

   La aplicación espera encontrar los archivos de credenciales .json en la carpeta de claves de cada proyecto. Ejemplo: keys/google-project-id1.json, keys/google-project-id2.json. Asegúrese de que la cuenta de servicio en la nube tenga los permisos necesarios para interactuar con Cloud Firestore (por ejemplo, Cloud Datastore Owner o permisos inferiores).

Herramientas disponibles

• getDocument : Obtener un documento por ID de una colección

• createDocument : Crea un nuevo documento en una colección

• updateDocument : Actualizar un documento existente

• deleteDocument : Eliminar un documento

• queryDocuments : Consulta documentos con filtros, ordenamiento y límites

• listCollections : Lista todas las colecciones disponibles

Ejemplo de uso en Claude Desktop

A continuación se muestran ejemplos de cómo utilizar cada herramienta en Claude Desktop:

Obtener un documento

Crear un documento

Actualizar un documento

Eliminar un documento

Consultar documentos

Colecciones de listas

Desarrollo

• Modo de vigilancia : npm run dev