mcp server

civitai-mcp

FastMCP bridge for Civitai: search and download checkpoints/LoRAs into a ComfyUI-compatible models depot. Dry-run default, human-approved download outbox.

sandraschi/civitai-mcpcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sandraschi-civitai-mcp": {
      "command": "uvx",
      "args": [
        "civitai-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 25, 2026

civitai-mcp

Civitai marketplace MCP — search / catalog / download checkpoints & LoRAs into a ComfyUI-compatible models depot. Complements comfyops-mcp (run graphs there; discover weights here).

v0.1.0 · Ports 11124 / 11125

FastMCP 3.4+ · dry-run default · human-approved download outbox · SOTA webapp

Principle

Agents search Civitai freely (public API). Large weight downloads go through outbox approve → publish. Live downloads need CIVITAI_API_TOKEN. Point CIVITAI_DEPOT_DIR (or COMFYOPS_MODELS_DIR) at your ComfyUI models/ tree.

Features

civitai_models portmanteau: search, get, version_get, creators, tags, download, pin_comfyops, list_local, outbox_*
Type → folder mapping (loras/, checkpoints/, vae/, …)
Prefab show_depot_card
Webapp: Dashboard, Search, Depot, Queue, Tools, Skills, Chat, Settings, Help (no social Inbox/Compose — Civitai is a marketplace, not a messenger)

Quick start

git clone https://github.com/sandraschi/civitai-mcp
cd civitai-mcp
Copy-Item .env.example .env
# set CIVITAI_API_TOKEN for downloads; optional CIVITAI_DEPOT_DIR
uv sync
.\start.bat

Dashboard: http://127.0.0.1:11125

Docs

See docs/ — especially ONBOARDING.md and TOOLS.md.

License

MIT