local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Serves as a FastMCP server implementation for the Replicate API, providing resource-based access to AI model inference with a focus on image generation.

Réplica del servidor MCP

Una implementación de servidor FastMCP para la API 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 a través de suscripciones
Configuración de parámetros basada en plantillas
🔍 Descubrimiento y selección de modelos integrales
🪝 Integración de webhook para notificaciones externas
🎨 Ajustes preestablecidos de calidad y estilo para obtener resultados óptimos
📊 Seguimiento del progreso y control del estado
🔒 Gestión segura de claves API

Indicaciones disponibles

El servidor proporciona varias indicaciones especializadas para diferentes tareas:

Texto a imagen (principal)

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

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

Ejemplo:

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

Otras indicaciones

Imagen a imagen : Transforma imágenes existentes (próximamente)
Selección de modelo : obtenga ayuda para elegir el modelo adecuado para su tarea
Ayuda de parámetros : comprender y configurar los parámetros del modelo

Prerrequisitos

Python 3.11 o superior
Una clave API de replicación (obtenga una en https://replicate.com/account )
UV para la gestión de la dependencia

Instalación

Instalación mediante herrería

Para instalar MCP Server Replicate para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

Puede 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 de escritorio de Claude

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

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

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

Agregue la configuración del servidor utilizando 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"
    }
  }
}

Establezca su clave API de replicación:

# 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

Reiniciar Claude Desktop por completo

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

Uso

Una vez conectado a Claude Desktop, podrá:

Generar imágenes con lenguaje natural:
Create a photorealistic mountain landscape at sunset with snow-capped peaks
Explora tus generaciones:
Show me my recent image generations
Búsqueda a través de generaciones:
Find my landscape generations
Comprobar 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

Consulte los registros de Claude Desktop:

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

Verifique su configuración:

Asegúrese de que la ruta en claude_desktop_config.json sea absoluta
Asegúrese de que UV esté instalado y en su PATH
Comprueba que tu clave API de replicación esté configurada

Intente reiniciar Claude Desktop

Para obtener una solución de problemas más detallada, consulte nuestra Guía de depuración .

Documentación

Desarrollo

Clonar el repositorio:

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

Instalar dependencias de desarrollo:

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

Instalar ganchos previos a la confirmación:

pre-commit install

Ejecutar pruebas:

pytest

Contribuyendo

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

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

Una implementación de servidor FastMCP que facilita el acceso basado en recursos a la inferencia de modelos de IA, centrándose en la generación de imágenes a través de la API Replicate, con características como actualizaciones en tiempo real, integración de webhook y administración segura de claves API.

Related Resources

Reddit Discussion about this server