Protokół Model Context Protocol (MCP) dla AI
Integracja SmallPict z Claude Desktop, Cursor, Google Antigravity i asystentami AI.
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.
End-to-End Image Processing & Edge CDN Flow
Sub-50ms image optimization lifecycle from client upload to global edge delivery.
- 01
Client Application
WordPress / SDK / API
Uploads raw image binary with HMAC-SHA256 signature and UUID v4 idempotency key.
Origin Request
- 02
smallPict Edge CDN
Global Edge PoPs
Checks global edge cache. On cache HIT, delivers AVIF/WebP in <20ms worldwide.
Cache & Delivery
- 03
SmallPict API Gateway
Authentication & Quotas
Validates HMAC credentials, verifies quota limits, and scopes access to customer_id.
Auth & Scoping
- 04
Optimization Engine
High-Speed Native Encoder
Multi-threaded quantization transcode to AVIF & WebP with no visible quality loss and much smaller files.
Transcoding
- 05
Secure Storage & Sync
Encrypted Cloud Storage
Stores optimized output, invalidates outdated cache tags, and warms the edge cache.
Persistent Sync
Zero Data Interception: End-to-end HMAC validation & SHA256 integrity check
Engine: smallPict
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:
{ "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):
{ "command": "npx", "args": [ "-y", "@smallpict/mcp" ], "env": { "SMALLPICT_API_KEY": "sp_sdk_your_key_here" }}