@swappr/mcp

Serveur MCP (Model Context Protocol) pour l'API Swappr. Permet à Claude Desktop, Cursor, Continue, Cline et tout client compatible MCP d'appeler directement les endpoints Swappr depuis une conversation.

Version : @swappr/[email protected] État doc : 1er sept. 2026 · API publique OpenAPI v1.6.0 · OAuth PKCE natif (Dynamic Client Registration).

Outils exposés

| Famille | Outils | |---|---| | Compte | swappr_start, swappr_me, swappr_credits_balance | | Studio | swappr_generate_image, swappr_generate_video, swappr_studio_models, swappr_tts, swappr_audio_dialogue | | Jobs | swappr_list_jobs, swappr_job_status | | Bibliothèque | swappr_list_library, swappr_save_library_item, swappr_list_models, swappr_upload | | Atelier | swappr_faceswap, swappr_faceswap_refine, swappr_faceswap_pricing, swappr_camera_roll_* | | Publier | swappr_publish_list_accounts, swappr_publish_account_detail, swappr_publish_list_posts, swappr_publish_create_post, swappr_publish_analytics, swappr_publish_refresh_analytics, swappr_publish_health_summary | | Webhooks | swappr_list_webhooks, swappr_register_webhook, swappr_delete_webhook |

Trafic (liens trackés) : disponible en API REST v1 (/links/*, /traffic/summary) mais retiré du MCP.

Avancé / hors directory : swappr_nude_factory_generate (bloqué au runtime hors NSFW), swappr_multiplier_server_run. Absents des listings Claude/ChatGPT.

Guide : https://swappr.fr/agent.md Hôtes Grok / Grok Bot / Groq : docs/ops/mcp-grok-hosts.md Stores : docs/ops/mcp-directory-submissions.md

Installation

# Méthode 1, directement via npx (recommandé)
npx -y @swappr/mcp

# Méthode 2, global install
npm install -g @swappr/mcp
swappr-mcp

Le serveur tourne sur stdio, il n'est pas lancé tout seul, il est invoqué par le client MCP.

Configuration Claude Desktop

Édite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :

{
  "mcpServers": {
    "swappr": {
      "command": "npx",
      "args": ["-y", "@swappr/mcp"]
    }
  }
}

Redémarre Claude Desktop. Au premier appel d’un outil swappr_*, le serveur ouvre le navigateur sur Swappr, demande votre consentement, puis stocke les tokens chiffrés dans ~/.swappr/tokens.json.

Configuration Cursor / Continue

Cursor : ~/.cursor/mcp.json (mêmes options qu'au-dessus). Continue : ajoute dans ~/.continue/config.json la section mcpServers.

Variables d'environnement

| Var | Requis | Défaut | Rôle | |---|---|---|---| | SWAPPR_BASE_URL | non | https://swappr.fr | Override pour staging/local |

Build local

cd packages/mcp-swappr
npm install
npm run build
node dist/index.js

Idempotency (POST génératifs)

Depuis sept. 2026, chaque POST MCP envoie automatiquement un header Idempotency-Key (mcp-<uuid>). Les retries côté API (même clé) renvoient la réponse mise en cache avec X-Idempotent-Replay: true.

Périmètre public

Le serveur MCP expose uniquement les parcours créatifs généralistes et safe-only. Les fonctionnalités sensibles du SaaS et les mécanismes de contournement de détection ne font pas partie du catalogue MCP.

Doc API

Endpoints REST sous-jacents : https://swappr.fr/api-docs OpenAPI YAML : https://swappr.fr/openapi.yaml

Sécurité

• OAuth PKCE + Dynamic Client Registration. Tokens chiffrés dans ~/.swappr/tokens.json.
• Scopes read generate uniquement.

Licence

MIT.