Replicate Designer

Replicate Designer MCP

Un servidor MCP para generar imágenes usando el modelo Flux 1.1 Pro de Replicate.

Instalación

Usando directamente desde GitHub

Puedes usar el servidor MCP directamente desde GitHub de varias maneras:

Opción 1: Instalar directamente con pip

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

Luego ejecútalo con:

mcp-replicate-designer

Opción 2: Usar npx con el repositorio de GitHub

Crea un archivo de configuración (por ejemplo, mcps.json):

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

Luego úsalo con Claude u otro asistente:

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

Este método te permite incluir tu token de API de Replicate directamente en el archivo de configuración, lo cual es más conveniente que configurar variables de entorno por separado.

Opción 3: Instalación local

Clona el repositorio e instala desde el directorio local:

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

Publicación y uso a través de npm

Para hacer que tu MCP esté disponible a través de npm (para una distribución más fácil):

1. Empaqueta y publica tu MCP:

# Build a wheel
pip install build
python -m build

# Publish to npm (after setting up an npm account)
npm init
npm publish

2. Luego los usuarios pueden instalarlo y usarlo directamente:

npx -y mcp-replicate-designer

Uso

Configuración del token de API

Hay varias formas de proporcionar tu token de API de Replicate:

1. Variable de entorno (para uso en línea de comandos):

   export REPLICATE_API_TOKEN=your_api_token_here
   

2. En el archivo de configuración de MCP (como se muestra en la Opción 2 anterior):

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

3. Usando un archivo .env en el directorio de tu proyecto:

   REPLICATE_API_TOKEN=your_api_token_here
   

   Luego, instala el paquete python-dotenv:

   pip install python-dotenv
   

Nota de seguridad: Ten cuidado con tus tokens de API. Nunca los comprometas en repositorios públicos y usa variables de entorno o gestión segura de secretos cuando sea posible.

Ejecutando el servidor MCP

mcp-replicate-designer

Por defecto, se ejecuta en modo stdio, que es compatible con el uso de npx. También puedes ejecutarlo en modo SSE:

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

Uso con npx

Este MCP se puede usar con un agente de IA usando npx de dos maneras:

Línea de comandos directa

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

Como objeto de configuración

En tu JSON de configuración:

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

Luego úsalo con:

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

Herramienta

Este MCP expone una sola herramienta:

generate_image

Genera una imagen usando el modelo Flux 1.1 Pro de Replicate.

Parámetros:

• prompt (string, requerido): Descripción de texto de la imagen a generar
• aspect_ratio (string, opcional, predeterminado: "1:1"): Relación de aspecto para la imagen generada
• output_format (string, opcional, predeterminado: "webp"): Formato de la imagen de salida
• output_quality (integer, opcional, predeterminado: 80): Calidad de la imagen de salida (1-100)
• safety_tolerance (integer, opcional, predeterminado: 2): Nivel de tolerancia de seguridad (0-3)
• prompt_upsampling (boolean, opcional, predeterminado: true): Si se debe usar el upsampling de prompt

Ejemplo:

{
  "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"
}