Protocolo de contexto de modelos (MCP)

Integra SmallPict con Claude Desktop, Cursor, Google Antigravity y asistentes de IA.

Integración con el protocolo Model Context Protocol (MCP)

SmallPict implementa el estándar abierto Model Context Protocol (MCP) desarrollado por Anthropic, permitiendo a los asistentes de IA interactuar directamente con tu infraestructura de imágenes.

Interactive Architecture Flowchart

End-to-End Image Processing & Edge CDN Flow

Sub-50ms image optimization lifecycle from client upload to Cloudflare Enterprise edge delivery.

Origin Request

Client Application

WordPress / SDK / API

Uploads raw image binary with HMAC-SHA256 signature and UUID v4 idempotency key.

Phase 1 Ready

Cache & Delivery

Cloudflare Edge CDN

Global Edge PoPs

Checks global edge cache. On cache HIT, delivers AVIF/WebP in <20ms worldwide.

Phase 2 Ready

Auth & Scoping

SmallPict Go Gateway

AWS Lambda / API Gateway

Validates HMAC credentials, verifies quota limits, and scopes access to customer_id.

Phase 3 Ready

Transcoding

libvips SIMD Worker

High-Speed C-Engine

Multi-threaded quantization transcode to AVIF & WebP with 0 visual loss and ~88% compression.

Phase 4 Ready

Persistent Sync

S3 Pipeline & Storage

Global Object Store

Stores optimized output, invalidates outdated cache tags, and hydrates Cloudflare Edge.

Phase 5 Ready

Zero Data Interception:End-to-end HMAC validation & SHA256 integrity check

Engine: libvips SIMD·Latency: <50ms

🛠️ Herramientas MCP disponibles

Herramienta	Descripción	Parámetros principales
`smallpict_optimize`	Optimiza una imagen local o remota a formatos AVIF/WebP.	`path`, `url`, `format`, `quality`, `max_width`
`smallpict_get_quota`	Consulta el consumo y saldo disponible de transformaciones.	Ninguno (utiliza la clave configurada)
`smallpict_purge_cdn`	Invalida recursos obsoletos en la CDN perimetral global.	`urls` (matriz de cadenas de texto)

⚙️ Configuración para clientes de IA

1. Claude Desktop

Añade la siguiente entrada a tu archivo claude_desktop_config.json:

JSON

{  "mcpServers": {    "smallpict": {      "command": "npx",      "args": [        "-y",        "@smallpict/mcp"      ],      "env": {        "SMALLPICT_API_KEY": "sp_sdk_your_key_here"      }    }  }}

2. Cursor IDE

En los ajustes de Cursor (Cursor Settings > Features > MCP), agrega un nuevo servidor con los siguientes valores:

Nombre: SmallPict
Tipo: command
Comando: npx -y @smallpict/mcp
Variable de entorno: SMALLPICT_API_KEY=sp_sdk_your_key_here

3. Google Antigravity

En el archivo de configuración de servidores MCP (~/.gemini/antigravity/mcp/smallpict.json):

JSON

{  "command": "npx",  "args": [    "-y",    "@smallpict/mcp"  ],  "env": {    "SMALLPICT_API_KEY": "sp_sdk_your_key_here"  }}

💬 Ejemplos de prompts en lenguaje natural

"Comprime todas las imágenes de la carpeta ./public/assets a formato AVIF con calidad 80 y dime cuánto peso logramos ahorrar."
"Consulta mi cuota restante en SmallPict para saber si tenemos saldo suficiente para la campaña de marketing."
"Purga la imagen https://cdn.smallpict.app/media/banner-verano.avif de los servidores perimetrales de la CDN porque acabamos de actualizar el diseño."