Agenten-Integration

QuokkaPix MCP Runner

Lokaler MCP-Adapter für Claude Desktop, Cursor, LM Studio/Ollama-Wrapper und andere Agenten. Er öffnet QuokkaPix in einem lokalen Browser, verarbeitet lokale Dateien und schreibt quokkapix-result.json.

agents.html agent-test.html GitHub

Was Agenten tun können

Offizielle Rezepte für Shopify, Amazon, Google Merchant, Metadatenbereinigung und Social Packs ausführen.
Direkte custom settings mit process_with_settings ausführen, mit demselben Payload wie window.QuokkaPixAgent.applySettings.
Result manifests validieren und QA-Prüfungen für Format, Abmessungen, Größenlimits und ZIP-Inhalte erhalten.
x402 payment options lesen und unlock tokens für bezahlte agent batch Läufe prüfen.
Lokale Asset-Dateien für Logo-Wasserzeichen und Hintergrundbild-Ersatz hochladen.

MCP-Tools

list_recipesget_recipevalidate_recipevalidate_result_manifestprocess_imagesprocess_with_settingsget_payment_optionsexplain_payment_flowverify_unlock_token

Einrichtung

{
  "mcpServers": {
    "quokkapix": {
      "command": "npx",
      "args": [
        "quokkapix-mcp"
      ],
      "env": {
        "QUOKKAPIX_APP_URL": "https://quokkapix.com/#agent=1"
      }
    }
  }
}

Beispiele

{
  "settings": {
    "mode": "single",
    "tool": "compress",
    "settings": {
      "compress": {
        "format": "webp",
        "quality": 0.82
      }
    }
  },
  "inputFiles": [
    "/Users/me/photo.jpg"
  ],
  "outputDir": "/Users/me/quokkapix-output"
}

Wichtige Hinweise

Dateien werden weiterhin nur über das lokale Browser-Dateifeld übergeben. QuokkaPix bietet keine öffentliche serverseitige Bildverarbeitungs-API.