Protokół Model Context Protocol (MCP) dla AI

Integracja SmallPict z Claude Desktop, Cursor, Google Antigravity i asystentami AI.

Integracja przez Model Context Protocol (MCP)

SmallPict natywnie obsługuje otwarty standard Model Context Protocol (MCP), co pozwala asystentom programistycznym AI na bezpośrednią pracę z multimediami za pomocą poleceń w języku naturalnym.

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

🛠️ Narzędzia protokołu MCP

Narzędzie	Działanie	Kluczowe parametry
`smallpict_optimize`	Optymalizuje pliki lokalne lub zdalne URL do AVIF/WebP.	`path`, `url`, `format`, `quality`, `max_width`
`smallpict_get_quota`	Odczytuje stan konta, limit i aktualne zużycie.	Brak (wykorzystuje skonfigurowany klucz)
`smallpict_purge_cdn`	Usuwa wskazane zasoby z globalnej pamięci Edge CDN.	`urls` (lista adresów)

⚙️ Konfiguracja edytorów AI

1. Claude Desktop

Dodaj do pliku 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

W Cursor Settings > Features > MCP:

Nazwa: SmallPict
Typ: command
Polecenie: npx -y @smallpict/mcp
Zmienna środowiskowa: SMALLPICT_API_KEY=sp_sdk_your_key_here

3. Google Antigravity

W pliku konfiguracyjnym (~/.gemini/antigravity/mcp/smallpict.json):

JSON

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