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

Related MCP server: GCP MCP

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

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