Replicate

Ejecuta modelos de IA para tareas como generación de imágenes usando la API de Replicate.

Documentación

MCP Server Replicate

Una implementación de servidor FastMCP para la API de Replicate, que proporciona acceso basado en recursos a la inferencia de modelos de IA con un enfoque en la generación de imágenes.

Características

🖼️ Generación y gestión de imágenes basada en recursos
🔄 Actualizaciones en tiempo real mediante suscripciones
📝 Configuración de parámetros basada en plantillas
🔍 Descubrimiento y selección integral de modelos
🪝 Integración de webhooks para notificaciones externas
🎨 Ajustes preestablecidos de calidad y estilo para resultados óptimos
📊 Seguimiento de progreso y monitoreo de estado
🔒 Gestión segura de claves de API

Prompts Disponibles

El servidor proporciona varios prompts especializados para diferentes tareas:

Texto a Imagen (Principal)

Nuestro prompt más probado y robusto. Optimizado para generar imágenes de alta calidad a partir de descripciones de texto con:

Control detallado de estilo
Ajustes preestablecidos de calidad (borrador, equilibrado, calidad, extremo)
Personalización de tamaño y relación de aspecto
Seguimiento de progreso y actualizaciones en tiempo real

Ejemplo:

Create a photorealistic mountain landscape at sunset with snow-capped peaks, quality level: quality, style: photorealistic

Otros Prompts

Imagen a Imagen: Transforma imágenes existentes (próximamente)
Selección de Modelo: Obtén ayuda para elegir el modelo adecuado para tu tarea
Ayuda de Parámetros: Comprende y configura los parámetros del modelo

Requisitos Previos

Python 3.11 o superior
Una clave de API de Replicate (obtén una en https://replicate.com/account)
UV para la gestión de dependencias

Instalación

Instalación mediante Smithery

Para instalar MCP Server Replicate para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @gerred/mcp-server-replicate --client claude

Instalación Manual

Puedes instalar el paquete directamente desde PyPI:

# Using UV (recommended)
uv pip install mcp-server-replicate

# Using UVX for isolated environments
uvx install mcp-server-replicate

# Using pip
pip install mcp-server-replicate

Integración con Claude Desktop

Asegúrate de tener instalada la última versión de Claude Desktop
Abre tu configuración de Claude Desktop:

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

Añade la configuración del servidor usando una de estas opciones:

{
  "globalShortcut": "Shift+Alt+A",
  "mcpServers": {
    "replicate": {
      "command": "uv",
      "args": ["tool", "run", "mcp-server-replicate"],
      "env": {
        "REPLICATE_API_TOKEN": "APITOKEN"
      },
      "cwd": "$PATH_TO_REPO"
    }
  }
}

Establece tu clave de API de Replicate:

# Option 1: Set in your environment
export REPLICATE_API_TOKEN=your_api_key_here

# Option 2: Create a .env file in your home directory
echo "REPLICATE_API_TOKEN=your_api_key_here" > ~/.env

Reinicia Claude Desktop por completo

Ahora deberías ver el icono 🔨 en Claude Desktop, lo que indica que el servidor MCP está disponible.

Uso

Una vez conectado a Claude Desktop, puedes:

Generar imágenes con lenguaje natural:

Create a photorealistic mountain landscape at sunset with snow-capped peaks

Explorar tus generaciones:
```
Show me my recent image generations
```
Buscar entre las generaciones:
```
Find my landscape generations
```

Verificar el estado de la generación:

What's the status of my last generation?

Solución de Problemas

El servidor no aparece en Claude Desktop

Revisa los registros de Claude Desktop:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Verifica tu configuración:

Asegúrate de que la ruta en claude_desktop_config.json sea absoluta
Asegúrate de que UV esté instalado y en tu PATH
Verifica que tu clave de API de Replicate esté configurada

Intenta reiniciar Claude Desktop

Para una solución de problemas más detallada, consulta nuestra Guía de Depuración.

Documentación

Desarrollo

Clona el repositorio:

git clone https://github.com/gerred/mcp-server-replicate.git
cd mcp-server-replicate

Instala las dependencias de desarrollo:

uv pip install --system ".[dev]"

Instala los hooks de pre-commit:

pre-commit install

Ejecuta las pruebas:

pytest

Contribución

¡Agradecemos las contribuciones! Consulta nuestra Guía de Contribución para más detalles.

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.