civitai-mcp-ultimate

Civitai API를 위한 가장 완벽한 MCP 서버 — 모델 검색, 프롬프트가 포함된 이미지 탐색, LoRA/체크포인트 다운로드, 트렌드 분석.

AI 어시스턴트를 통해 모든 작업을 수행하세요. Civitai 공개 REST API v1의 100%를 커버하는 14개의 도구를 제공합니다.

모든 API 매개변수는 2026년 3월 24일 기준 실제 Civitai API를 통해 검증되었습니다. 추측이나 잘못된 구현을 복사하지 않았습니다.

기능

• Meilisearch 기반 검색 — 빠르고 정확한 텍스트 검색 (Civitai REST API 검색은 2025년 5월부터 작동하지 않음)

• 모델 검색 — 40개 이상의 기본 모델 필터(SD 1.5 → Flux.2)를 갖춘 체크포인트, LoRA, ControlNet 검색

• 프롬프트가 포함된 인기 이미지 — 반응, 댓글, 컬렉션별 정렬. 전체 생성 매개변수 획득

• 다운로드 명령 — 인증이 포함된 curl/PowerShell 명령, ComfyUI 경로 자동 매핑

• NSFW 지원 — API 키를 통한 전체 NSFW 액세스 (None/Soft/Mature/X 필터링)

• 이미지/비디오 캐시 — ~/.civitai-mcp-cache/로 미리보기 자동 다운로드, 24시간 자동 정리

• 이중 언어 출력 — 영어 및 러시아어 (CIVITAI_MCP_LANG=ru)

• 비동기 및 고속 — httpx 비동기 클라이언트, 속도 제한 시 백오프를 통한 재시도

• 14개의 도구 — Civitai 공개 REST API v1의 100% 커버

빠른 시작

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의 다른 프로젝트

저자 후원

저는 오픈 소스 소프트웨어를 만들고 AI 연구를 수행합니다. 제가 만드는 대부분의 것은 무료이며 누구나 사용할 수 있습니다. 여러분의 후원은 제가 다음 식사를 걱정하지 않고 계속해서 창작할 수 있도록 도와줍니다 =)

모든 후원 방법 | dalink.to/nerual_dreming | boosty.to/neuro_art

• BTC: 1E7dHL22RpyhJGVpcvKdbyZgksSYkYeEBC

• ETH (ERC20): 0xb5db65adf478983186d4897ba92fe2c25c594a0c

• USDT (TRC20): TQST9Lp2TjK6FiVkn4fwfGUee7NmkxEE7C

Star History

라이선스

MIT