civitai-mcp-ultimate

El servidor MCP más completo para la API de Civitai: busca modelos, explora imágenes con prompts, descarga LoRAs/Checkpoints y analiza tendencias.

Todo desde tu asistente de IA. 14 herramientas que cubren el 100% de la API REST pública v1 de Civitai.

Todos los parámetros de la API verificados con la API real de Civitai el 24-03-2026. Sin suposiciones, sin copiar de implementaciones rotas.

Características

• Búsqueda impulsada por Meilisearch — búsqueda de texto rápida y precisa (la búsqueda de la API REST de Civitai no funciona desde mayo de 2025)

• Búsqueda de modelos — Checkpoints, LoRAs, ControlNets con más de 40 filtros de modelos base (SD 1.5 → Flux.2)

• Imágenes destacadas con prompts — ordena por reacciones, comentarios, colecciones. Obtén parámetros de generación completos

• Comandos de descarga — comandos curl/PowerShell con autenticación, mapeo automático de rutas de ComfyUI

• Soporte NSFW — acceso completo a contenido NSFW con clave API (filtrado Ninguno/Suave/Maduro/X)

• Caché de imágenes/vídeos — descarga automática de vistas previas en ~/.civitai-mcp-cache/, limpieza automática cada 24h

• Salida bilingüe — inglés y ruso (CIVITAI_MCP_LANG=ru)

• Asíncrono y rápido — cliente asíncrono httpx, reintento con retroceso exponencial ante límites de tasa

• 14 herramientas que cubren el 100% de la API REST pública v1 de Civitai

Inicio rápido

Instalar desde PyPI

pip install civitai-mcp-ultimate

Claude Code

claude mcp add civitai -e CIVITAI_API_KEY=your_key_here -- uvx civitai-mcp-ultimate

Claude Desktop

Añadir a claude_desktop_config.json:

{
  "mcpServers": {
    "civitai": {
      "command": "uvx",
      "args": ["civitai-mcp-ultimate"],
      "env": {
        "CIVITAI_API_KEY": "your_key_here"
      }
    }
  }
}

pip

pip install civitai-mcp-ultimate
civitai-mcp-ultimate

Herramientas

Modelos (6 herramientas)

Imágenes (4 herramientas)

Creadores y etiquetas (2 herramientas)

Descargas (2 herramientas)

Filtros soportados

Modelos base (todos verificados y funcionando)

SD 1.5, SD 1.5 LCM, SD 1.5 Hyper, SD 2.0, SD 2.1, SDXL 1.0, SDXL Lightning, SDXL Hyper, Flux.1 S, Flux.1 D, Flux.1 Krea, Flux.1 Kontext, Flux.2 D, Flux.2 Klein 9B/4B, Pony, Pony V7, Illustrious, NoobAI, Anima, ZImageBase, AuraFlow, Chroma, HiDream, Hunyuan 1, Kolors, PixArt a/E, Lumina, CogVideoX, Hunyuan Video, LTXV/LTXV2, Mochi, Wan Video (todas las variantes)

Tipos de modelo

Checkpoint, LORA, LoCon, TextualInversion, Hypernetwork, Controlnet, Poses, AestheticGradient, Wildcards, MotionModule, VAE, Upscaler, Workflows, Other

Orden de imágenes

Más reacciones, Más comentarios, Más coleccionadas, Más recientes, Más antiguas

Configuración

Obtén tu clave API: Configuración de cuenta de Civitai

Ejemplos

> Search for the top Flux LoRAs this month
> Show me the most popular SDXL checkpoints
> Get the best prompts for model 12345
> Give me download commands for this LoRA into my ComfyUI
> Find NSFW LoRAs for Illustrious sorted by reactions

Desarrollo

git clone https://github.com/timoncool/civitai-mcp-ultimate
cd civitai-mcp-ultimate
pip install -e ".[dev]"
pytest

Autor

Nerual Dreming (t.me/nerual_dreming) — neuro-cartel.com | fundador de ArtGeneration.me

Otros proyectos de @timoncool

Apoya al autor

Desarrollo software de código abierto y realizo investigación en IA. La mayor parte de lo que creo es gratuito y está disponible para todos. Tus donaciones me ayudan a seguir creando sin preocuparme por la próxima comida =)

Todos los métodos de donación | dalink.to/nerual_dreming | boosty.to/neuro_art

• BTC: 1E7dHL22RpyhJGVpcvKdbyZgksSYkYeEBC

• ETH (ERC20): 0xb5db65adf478983186d4897ba92fe2c25c594a0c

• USDT (TRC20): TQST9Lp2TjK6FiVkn4fwfGUee7NmkxEE7C

Historial de estrellas

Licencia

MIT