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

Related MCP server: MCP Server for Replicate

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

1. Asegúrate de tener instalada la última versión de Claude Desktop

2. 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

3. 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"
    }
  }
}

4. 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

5. 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á:

1. Generar imágenes con lenguaje natural:

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

2. Explora tus generaciones:

   Show me my recent image generations

3. Búsqueda a través de generaciones:

   Find my landscape generations

4. 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

1. Consulte los registros de Claude Desktop:

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

2. 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

3. Intente reiniciar Claude Desktop

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

Documentación

• Plan de Implementación

• Guía de contribución

• Referencia de API

• Sistema de recursos

• Sistema de plantillas

Desarrollo

1. Clonar el repositorio:

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

2. Instalar dependencias de desarrollo:

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

3. Instalar ganchos previos a la confirmación:

pre-commit install

4. 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.