Replicate Designer MCP

Un servidor MCP per generar imatges utilitzant el model Flux 1.1 Pro de Replicate.

Instal·lació

Utilitzant directament GitHub

Pots utilitzar el servidor MCP directament des de GitHub de diverses maneres:

Opció 1: Instal·lar directament amb pip

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

Després l'executa amb:

mcp-replicate-designer

Opció 2: Utilitzar npx amb el repositori GitHub

Crea un fitxer de configuració (p. ex. mcps.json):

{
  "mcpServers": {
    "replicateDesigner": {
      "command": "npx",
      "args": [
        "-y", 
        "github:yourusername/replicate-designer"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_api_token_here"
      }
    }
  }
}

Llavors utilitza-ho amb Claude o un altre assistent:

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

Aquest mètode permet incloure el teu token d'API de Replicate directament al fitxer de configuració, el que és més còmode que establir variables d'entorn per separat.

Opció 3: Instal·lació local

Clona el repositori i instal·la des del directori local:

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

Publicació i ús via npm

Per fer que el teu MCP estigui disponible via npm (per a una distribució més fàcil):

1. Empaqueta i publica el teu MCP:

# Construir una wheel
pip install build
python -m build

# Publicar a npm (després de configurar un compte npm)
npm init
npm publish

2. Llavors els usuaris poden instal·lar i utilitzar-lo directament:

npx -y mcp-replicate-designer

Ús

Configuració del token d'API

Hi ha diverses maneres de proporcionar el teu token d'API de Replicate:

1. Variable d'entorn (per a ús en línia de comandes):

   export REPLICATE_API_TOKEN=your_api_token_here
   

2. Al fitxer de configuració MCP (tal com es mostra en l'Opció 2 anterior):

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

3. Utilitzant un fitxer .env al directori del teu projecte:

   REPLICATE_API_TOKEN=your_api_token_here
   

   Després, instal·la el paquet python-dotenv:

   pip install python-dotenv
   

Nota de seguretat: Cuida els teus tokens d'API. No els commitin a repositoris públics i utilitza variables d'entorn o gestió segura de secrets quan sigui possible.

Execució del servidor MCP

mcp-replicate-designer

Per defecte, s'executa en mode stdio, que és compatible amb l'ús de npx. També pots executar-lo en mode SSE:

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

Ús amb npx

Aquest MCP es pot utilitzar amb un agent d'IA amb npx de dues maneres:

Línia de comandes directa

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

Com a objecte de configuració

Al teu JSON de configuració:

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

Llavors utilitza-ho amb:

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

Eina

Aquest MCP expone una única eina:

generate_image

Genera una imatge utilitzant el model Flux 1.1 Pro de Replicate.

Paràmetres:

• prompt (string, obligatori): Descripció de text de la imatge a generar
• aspect_ratio (string, opcional, per defecte: "1:1"): Relació d'aspecte per a la imatge generada
• output_format (string, opcional, per defecte: "webp"): Format de la imatge de sortida
• output_quality (integer, opcional, per defecte: 80): Qualitat de la imatge de sortida (1-100)
• safety_tolerance (integer, opcional, per defecte: 2): Nivell de tolerància de seguretat (0-3)
• prompt_upsampling (boolean, opcional, per defecte: true): Si s'utilitza l'upsampling del prompt

Exemple:

{
  "prompt": "A photograph of an humanoid AI agent looking sad and in disrepair, the agent is sat at a workbench getting fixed by a human male",
  "aspect_ratio": "1:1",
  "output_format": "webp"
}