civitai-mcp-ultimate

Самый полный MCP-сервер для API Civitai — поиск моделей, просмотр изображений с промптами, загрузка LoRA/чекпоинтов, анализ трендов.

Все это прямо из вашего ИИ-ассистента. 14 инструментов, покрывающих 100% публичного REST API v1 Civitai.

Все параметры API проверены на реальном API Civitai по состоянию на 24.03.2026. Никаких догадок, никакого копирования из нерабочих реализаций.

Возможности

• Поиск на базе Meilisearch — быстрый и точный текстовый поиск (поиск через REST API Civitai не работает с мая 2025 года)

• Поиск моделей — чекпоинты, LoRA, ControlNet с фильтрами по 40+ базовым моделям (от SD 1.5 до Flux.2)

• Топ изображений с промптами — сортировка по реакциям, комментариям, коллекциям. Получение полных параметров генерации

• Команды для загрузки — команды curl/PowerShell с авторизацией, автоматическое сопоставление путей для ComfyUI

• Поддержка NSFW — полный доступ к NSFW с API-ключом (фильтрация None/Soft/Mature/X)

• Кэш изображений/видео — автоматическая загрузка превью в ~/.civitai-mcp-cache/, автоочистка каждые 24 часа

• Двуязычный вывод — английский и русский (CIVITAI_MCP_LANG=ru)

• Асинхронность и скорость — асинхронный клиент httpx, повторные попытки с экспоненциальной задержкой при достижении лимитов

• 14 инструментов, покрывающих 100% публичного REST API v1 Civitai

Быстрый старт

Установка из 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

Добавьте в 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

Инструменты

Модели (6 инструментов)

Изображения (4 инструмента)

Авторы и теги (2 инструмента)

Загрузки (2 инструмента)

Поддерживаемые фильтры

Базовые модели (все проверены и работают)

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 (все варианты)

Типы моделей

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

Сортировка изображений

Больше всего реакций, Больше всего комментариев, Больше всего добавлений в коллекции, Новые, Старые

Конфигурация

Получите свой API-ключ: Настройки аккаунта Civitai

Примеры

> 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

Разработка

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

Автор

Nerual Dreming (t.me/nerual_dreming) — neuro-cartel.com | основатель ArtGeneration.me

Другие проекты от @timoncool

Поддержать автора

Я создаю open-source ПО и занимаюсь ИИ-исследованиями. Большая часть того, что я делаю, бесплатна и доступна каждому. Ваши донаты помогают мне продолжать творить, не беспокоясь о том, на что купить еду =)

Все способы доната | dalink.to/nerual_dreming | boosty.to/neuro_art

• BTC: 1E7dHL22RpyhJGVpcvKdbyZgksSYkYeEBC

• ETH (ERC20): 0xb5db65adf478983186d4897ba92fe2c25c594a0c

• USDT (TRC20): TQST9Lp2TjK6FiVkn4fwfGUee7NmkxEE7C

История звезд

Лицензия

MIT