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
Instalación
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:
- Ejecutar pruebas:
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.