Replicate Designer MCP

Un serveur MCP pour générer des images en utilisant le modèle Flux 1.1 Pro de Replicate.

Installation

Utilisation directe depuis GitHub

Vous pouvez utiliser le serveur MCP directement depuis GitHub de plusieurs manières :

Option 1 : Installer directement avec pip

pip install git+https://github.com/yourusername/replicate-designer.git

Exécutez-le ensuite avec :

mcp-replicate-designer

Option 2 : Utiliser npx avec le dépôt GitHub

Créer un fichier de configuration (par exemple, mcps.json) :

{ "mcpServers" : { "replicateDesigner" : { "command" : "npx", "args" : [ "-y", "github:votre nom d'utilisateur/replicate-designer" ], "env" : { "REPLICATE_API_TOKEN" : "your_replicate_api_token_here" } } } }

Utilisez-le ensuite avec Claude ou un autre assistant :

npx @anthropic-ai/assistant --mcps-json mcps.json

Cette méthode vous permet d'inclure votre jeton API Replicate directement dans le fichier de configuration, ce qui est plus pratique que de définir des variables d'environnement séparément.

Option 3 : Installation locale

Clonez le dépôt et installez à partir du répertoire local :

git clone https://github.com/yourusername/replicate-designer.git cd replicate-designer pip install -e

Publication et utilisation via npm

Pour rendre votre MCP disponible via npm (pour une distribution plus facile) :

1. Empaquetez et publiez votre MCP :

# Construire une roue pip install build python -m build # Publier sur npm (après avoir créé un compte npm) npm init npm publish

2. Ensuite, les utilisateurs peuvent l'installer et l'utiliser directement :

npx -y mcp-replicate-designer

Utilisation

Définition du jeton API

Il y a plusieurs façons de fournir votre jeton API Replicate :

1. Variable d'environnement (pour une utilisation en ligne de commande) :

   export REPLICATE_API_TOKEN=votre_jeton_api_ici

2. Dans le fichier de configuration MCP (comme indiqué dans l'option 2 ci-dessus) :

   { "mcpServers" : { "replicateDesigner" : {"command" : "...", "args" : ["..."], "env" : { "REPLICATE_API_TOKEN" : "your_replicate_api_token_here" } } } }

3. Utilisation d'un fichier .env dans le répertoire de votre projet :

   REPLICATE_API_TOKEN=votre_token_api_ici

   Ensuite, installez le paquet python-dotenv :

   pip install python-dotenv

Note de sécurité: Soyez prudent avec vos jetons d'API. Ne les mettez jamais dans des dépôts publics, et utilisez des variables d'environnement ou une gestion sécurisée des secrets lorsque c'est possible.

Exécution du serveur MCP

mcp-replicate-designer

Par défaut, il fonctionne en mode stdio, ce qui est compatible avec l'utilisation de npx. Vous pouvez également l'exécuter en mode SSE :

mcp-replicate-designer --transport sse --port 8000

Utilisation avec npx

Ce MCP peut être utilisé avec un agent IA utilisant npx de deux manières :

Ligne de commande directe

npx @anthropic-ai/assistant --mcp mcp-replicate-designer

En tant qu'objet de configuration

Dans votre configuration JSON :

{ "mcpServers" : { "replicateDesigner" : { "command" : "npx", "args" : [ "-y", "mcp-replicate-designer" ] } } }

Puis utilisez-le avec :

npx @anthropic-ai/assistant --mcps-json /path/to/your/config.json

Outil

Ce MCP expose un seul outil :

generate_image

Génère une image en utilisant le modèle Flux 1.1 Pro de Replicate.

Paramètres :

• prompt (chaîne, obligatoire) : Description textuelle de l'image à générer
• aspect_ratio (chaîne, optionnel, défaut : "1:1") : Rapport d'aspect de l'image générée
• output_format (string, optionnel, par défaut : "webp") : Format de l'image de sortie
• output_quality (integer, optionnel, par défaut : 80) : Qualité de l'image de sortie (1-100)
• safety_tolerance (entier, optionnel, par défaut : 2) : Niveau de tolérance de sécurité (0-3)
• prompt_upsampling (booléen, facultatif, valeur par défaut : true) : Utiliser ou non le suréchantillonnage rapide

Exemple :

{"prompt" : "Une photographie d'un agent IA humanoïde à l'air triste et en mauvais état, l'agent est assis à un établi et se fait réparer par un homme", "aspect_ratio" : "1:1", "output_format" : "webp" }