civitai-mcp-ultimate
MCP-сервер к Civitai: поиск моделей и LoRA, просмотр картинок с промптами, команды на скачивание, разбор трендов, вывод на двух языках
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Ходит в сеть к API Civitai и Meilisearch
- Скачивает превью в локальный кеш на диске
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/civitai-mcp-ultimateОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio civitai -- uvx civitai-mcp-ultimateИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"civitai": {
"command": "uvx",
"args": [
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"civitai": {
"command": "uvx",
"args": [
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"civitai","type":"stdio","command":"uvx","args":["civitai-mcp-ultimate"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"civitai": {
"type": "stdio",
"command": "uvx",
"args": [
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add civitai -- uvx civitai-mcp-ultimateИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.civitai]
command = "uvx"
args = ["civitai-mcp-ultimate"]Если файл уже есть, допишите блок в конец.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user civitai uvx civitai-mcp-ultimateИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"civitai": {
"command": "uvx",
"args": [
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"civitai": {
"command": "uvx",
"args": [
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"civitai": {
"command": "uvx",
"args": [
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"civitai": {
"command": "uvx",
"args": [
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"civitai": {
"type": "local",
"command": [
"uvx",
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"civitai": {
"command": "uvx",
"args": [
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"civitai": {
"command": "uvx",
"args": [
"civitai-mcp-ultimate"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
CIVITAI_API_KEYсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Подключи MCP-сервер Civitai. В Claude Code: claude mcp add civitai -e CIVITAI_API_KEY=твой_ключ -- uvx civitai-mcp-ultimate. Ключ можно не указывать, тогда NSFW недоступен и лимиты ниже.
Другие способы из описания автора
pip install civitai-mcp-ultimateПакет из PyPI, запуск командой civitai-mcp-ultimate.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает публичный REST API Civitai для агента через 14 инструментов. Через них можно искать чекпойнты, LoRA и ControlNet с фильтрами по базовой модели, типу, тегу и автору, смотреть топ картинок с полными параметрами генерации, находить модель по хешу файла и получать данные версии с триггер-словами и ссылками. Текстовый поиск идет через Meilisearch, потому что штатный поиск Civitai сломан с середины 2025 года. Есть готовые команды на скачивание для curl и PowerShell с подстановкой путей ComfyUI, кеш превью и вывод на английском или русском. Сервер написан на Python с FastMCP и работает по stdio.
Для кого. Для дизайнеров и создателей контента, которые собирают модели и промпты для Stable Diffusion, Flux и подобных через своего агента.
Подходит, если
- Нужно найти подходящие LoRA или чекпойнты под базовую модель и отсортировать по популярности
- Нужно вытащить рабочие промпты и параметры генерации из топовых картинок
- Нужно получить команду для скачивания модели с авторизацией и раскладкой под ComfyUI
Не подходит, если
- Нужна генерация изображений, а не поиск и метаданные с Civitai
- Civitai недоступен из вашей сети, а VPN использовать нельзя
Пример запроса к агенту
Найди топовые LoRA для Flux за этот месяц и покажи лучшие промпты по каждойОграничения
Сервер работает поверх Civitai, поэтому зависит от доступности civitai.com, ее из России без VPN стоит проверить отдельно. Ключ CIVITAI_API_KEY не обязателен, но без него закрыт NSFW-контент и ниже лимиты запросов. Текстовый поиск идет через Meilisearch, так как REST-поиск Civitai не работает. Сам сервер картинки не генерирует, он только ищет модели, метаданные и готовит команды на скачивание.
Как отключить. Уберите сервер civitai из конфигурации MCP-клиента. Пакет удаляется через pip uninstall civitai-mcp-ultimate, если он был установлен, кеш превью лежит в ~/.civitai-mcp-cache/.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| CIVITAI_API_KEY секрет | Ключ Civitai для доступа к NSFW и более высоких лимитов, берется в настройках аккаунта. |
| CIVITAI_MCP_LANG | Язык вывода, en или ru, по умолчанию en. |
| COMFYUI_MODELS_PATH | Путь к моделям ComfyUI для команд на скачивание. |
| MEILISEARCH_KEY | Ключ Meilisearch только на чтение, есть встроенный публичный по умолчанию. |
Проверка безопасности
- Ходит в сеть к API Civitai и Meilisearch
- Скачивает превью в локальный кеш на диске
Коротко о README
README представляет сервер как полное покрытие публичного REST API Civitai v1 в 14 инструментах, разбитых на модели, картинки, авторов и теги, скачивание. Параметры сверены с живым API, а текстовый поиск вынесен в Meilisearch из-за поломки штатного поиска. Ставится из PyPI через pip или запускается через uvx, есть конфигурации для Claude Code, Claude Desktop и Smithery. Настройки задаются переменными окружения: ключ Civitai, язык вывода, путь ComfyUI и ключ Meilisearch. Есть кеш превью с автоочисткой, асинхронный клиент и повтор запросов при лимитах. Лицензия MIT.
Частые вопросы
Нужен ли ключ Civitai?
Не обязателен. Без ключа поиск, картинки и метаданные работают, но NSFW-контент закрыт и лимиты запросов ниже. Ключ берется в настройках аккаунта Civitai.
Почему поиск идет через Meilisearch?
Штатный текстовый поиск REST API Civitai не работает с середины 2025 года, поэтому сервер использует Meilisearch с публичным ключом только на чтение, его можно переопределить своим.
Похожие
Скиллы и CLI от HeyGen: агент пишет HTML-композиции и рендерит из них MP4-ролики, субтитры, моушн-графику и слайды
Blender MCP
MCP for Blender
MCP-сервер и аддон для Blender: агент создает и меняет объекты, материалы и сцены, подгружает ассеты и выполняет Python в Blender
Скиллы Remotion
Remotion Agent Skills
Официальные скиллы Remotion для создания видео на React: композиции, анимации, субтитры, карты и рендер
Агентная видеостудия для Claude Code, Cursor и Codex: сценарий, озвучка, картинки, стоковые кадры, музыка, субтитры и рендер