cloudinary-mcp-server

Servidor MCP de Cloudinary

Un servidor de Protocolo de Contexto de Modelo que expone los métodos de la API de Carga y Administración de Cloudinary como herramientas para los asistentes de IA. Esta integración permite que los sistemas de IA activen e interactúen con su nube de Cloudinary.

Cómo funciona

El servidor MCP:

• Realiza llamadas en su nombre a la API de Cloudinary
• Permite la carga de activos a Cloudinary
• Permite la gestión de activos en su nube Cloudinary

Se basa en la API de Cloudinary para realizar estas acciones. No todos los métodos y parámetros son compatibles. Se añadirán más con el tiempo.

Abra un problema con una solicitud de un método específico si lo necesita.

Beneficios

• Convierta sus acciones en la nube de Cloudinary en herramientas invocables para asistentes de IA
• Convierta sus activos de Cloudinary en datos para asistentes de IA

Uso con Claude Desktop

Prerrequisitos

• NodeJS
• Cliente MCP (como la aplicación de escritorio Claude)
• Cree y copie la clave/secreto de API de Cloudinary en: API KEYS

Instalación

Para usar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a la sección "mcpServers" de su claude_desktop_config.json :

• CLOUDINARY_CLOUD_NAME - el nombre de tu nube
• CLOUDINARY_API_KEY : La clave API para tu nube
• CLOUDINARY_API_SECRET : El secreto de la API para tu nube

Herramientas

Las siguientes herramientas están disponibles:

1. subir
   • Descripción: Subir un archivo (activo) a Cloudinary
   • Parámetros:
     • source : URL, ruta de archivo, contenido base64 o datos binarios para cargar
     • folder : Ruta de carpeta opcional en Cloudinary
     • publicId : ID público opcional para el activo cargado
     • resourceType : Tipo de recurso a cargar (imagen, video, sin procesar, automático)
     • tags : Lista separada por comas de etiquetas para asignar al activo
2. eliminar activo
   • Descripción: Eliminar un archivo (activo) de Cloudinary
   • Parámetros:
     • publicId : El ID público del activo que se eliminará
     • assetId : El ID del activo que se eliminará
3. obtener activo
   • Descripción: Obtenga los detalles de un archivo específico (activo)
   • Parámetros:
     • assetId : El ID del activo de Cloudinary
     • publicId : El ID público del activo
     • resourceType : Tipo de activo (imagen, sin procesar, video)
     • type : Tipo de entrega (carga, privada, autenticada, etc.)
     • tags : si se debe incluir la lista de nombres de etiquetas
     • context : si se deben incluir metadatos contextuales
     • metadata : si se deben incluir metadatos estructurados
4. encontrar activos
   • Descripción: Busque archivos existentes (activos) en Cloudinary con una expresión de consulta
   • Parámetros:
     • expression : expresión de búsqueda (por ejemplo, 'tags=cat' o 'public_id:folder/*')
     • resourceType : Tipo de recurso (imagen, vídeo, sin procesar)
     • maxResults : Número máximo de resultados (1-500)
     • nextCursor : Siguiente cursor para paginación
     • tags : Incluir etiquetas en la respuesta
     • context : Incluir contexto en la respuesta
5. obtener-uso
   • Descripción: Obtenga un informe sobre el estado de uso del entorno de su producto, incluido el almacenamiento, los créditos, el ancho de banda, las solicitudes, la cantidad de recursos y el uso de complementos.
   • Parámetros:
     • date : Opcional. La fecha del informe de uso en formato aaaa-mm-dd. Debe estar dentro de los últimos 3 meses. Predeterminado: la fecha actual.