Skip to main content
Glama

civitai-mcp-ultimate

Civitai APIのための最も完全なMCPサーバー — モデル検索、プロンプト付き画像の閲覧、LoRA/チェックポイントのダウンロード、トレンド分析が可能。

Stars PyPI License TRAIL

すべて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ツール)

ツール

説明

search_models

Meilisearch(テキスト)またはREST API(フィルタ)による検索。タイプ、ベースモデル、タグ、作成者、ソートを指定

get_model

IDによるモデルの詳細情報

get_model_version

バージョン詳細:ファイル、トリガーワード、ダウンロードURL

get_model_version_by_hash

ファイルハッシュによるモデル検索

get_top_checkpoints

ベースモデルごとのトップチェックポイント (SDXL, Flux, Pony...)

get_top_loras

ベースモデルごとのトップLoRA

画像 (4ツール)

ツール

説明

browse_images

フィルタとソートを使用した画像の閲覧

get_top_images

リアクション/コメント/コレクション数によるトップ画像

get_model_images

プロンプト付きのモデルサンプル画像

get_image_generation_data

トップ画像からの完全な生成パラメータ

作成者とタグ (2ツール)

ツール

説明

get_creators

モデル作成者の閲覧/検索

get_tags

モデルタグの閲覧/検索

ダウンロード (2ツール)

ツール

説明

get_download_url

認証済みダウンロードURL

get_download_info

ダウンロードコマンド (curl/PowerShell) + ComfyUIパスのマッピング


サポートされているフィルタ

ベースモデル (すべて動作検証済み)

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

画像ソート

Most Reactions, Most Comments, Most Collected, Newest, Oldest


設定

変数

必須

デフォルト

説明

CIVITAI_API_KEY

推奨

NSFWアクセスおよび高いレート制限のためのAPIキー

CIVITAI_MCP_LANG

いいえ

en

出力言語: en または ru

COMFYUI_MODELS_PATH

いいえ

ダウンロードコマンド用のComfyUIモデルパス

MEILISEARCH_KEY

いいえ

内蔵

Meilisearch検索専用キー(公開、デフォルトあり)

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 による他のプロジェクト

プロジェクト

説明

telegram-api-mcp

MCPサーバーとしての完全なTelegram Bot API

trail-spec

TRAIL — クロスMCPコンテンツ追跡プロトコル

ACE-Step Studio

AI音楽スタジオ — 楽曲、ボーカル、カバー、動画

VideoSOS

ブラウザベースのAI動画制作

Bulka

ライブコーディング音楽プラットフォーム

GitLife

あなたの人生を週単位で表示 — インタラクティブカレンダー

作者を支援する

私はオープンソースソフトウェアの開発とAI研究を行っています。私が作成するもののほとんどは無料で、誰でも利用できます。皆様からの寄付は、生活の心配をすることなく創作活動を続けるための大きな助けとなります =)

すべての寄付方法 | dalink.to/nerual_dreming | boosty.to/neuro_art

  • BTC: 1E7dHL22RpyhJGVpcvKdbyZgksSYkYeEBC

  • ETH (ERC20): 0xb5db65adf478983186d4897ba92fe2c25c594a0c

  • USDT (TRC20): TQST9Lp2TjK6FiVkn4fwfGUee7NmkxEE7C

スターの推移

ライセンス

MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/timoncool/civitai-mcp-ultimate'

If you have feedback or need assistance with the MCP directory API, please join our Discord server