Protocollo Model Context Protocol (MCP)

Integrazione di SmallPict con Claude Desktop, Cursor, Google Antigravity e agenti IA.

Integrazione con il protocollo Model Context Protocol (MCP)

SmallPict supporta lo standard aperto Model Context Protocol (MCP) introdotto da Anthropic, consentendo agli agenti IA di interagire direttamente con la piattaforma tramite istruzioni in linguaggio naturale.

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

🛠️ Strumenti MCP disponibili

Strumento	Descrizione	Parametri principali
`smallpict_optimize`	Ottimizza immagini locali o URL remoti in AVIF/WebP.	`path`, `url`, `format`, `quality`, `max_width`
`smallpict_get_quota`	Consulta il saldo di quota rimanente e il consumo.	Nessuno (impiega la chiave configurata)
`smallpict_purge_cdn`	Invalida le risorse memorizzate nella cache Edge della CDN.	`urls` (lista di link)

⚙️ Configurazione degli editor IA

1. Claude Desktop

Inserisci nel file 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

In Cursor Settings > Features > MCP:

Nome: SmallPict
Tipo: command
Comando: npx -y @smallpict/mcp
Variabile: SMALLPICT_API_KEY=sp_sdk_your_key_here

3. Google Antigravity

Nel file di configurazione (~/.gemini/antigravity/mcp/smallpict.json):

JSON

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