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

Instalar dependencias :
npm install
Construir el proyecto :
npm run build
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

Get the document with ID "user123" from the "users" collection

Crear un documento

Create a new document in the "users" collection with the following data:
{
  "name": "John Doe",
  "email": "john@example.com",
  "age": 30
}

Actualizar un documento

Update the document with ID "user123" in the "users" collection to change the age to 31

Eliminar un documento

Delete the document with ID "user123" from the "users" collection

Consultar documentos

Find all users over 25 years old, ordered by name

Colecciones de listas

List all available Firestore collections

Desarrollo

Modo de vigilancia : npm run dev