civitai-mcp-ultimate

最完整的 Civitai API MCP 服务器 —— 搜索模型、浏览带有提示词的图像、下载 LoRA/Checkpoints、分析趋势。

一切尽在你的 AI 助手之中。14 个工具涵盖了 100% 的 Civitai 公共 REST API v1。

所有 API 参数均已于 2026-03-24 在真实的 Civitai API 上验证。没有猜测，没有从损坏的实现中复制。

功能

• 基于 Meilisearch 的搜索 —— 快速、准确的文本搜索（Civitai REST API 的搜索功能自 2025 年 5 月起已损坏）

• 搜索模型 —— Checkpoints、LoRAs、ControlNets，支持 40 多种基础模型过滤器（SD 1.5 → Flux.2）

• 热门图像及提示词 —— 按反应、评论、收藏排序。获取完整的生成参数

• 下载命令 —— 带有身份验证的 curl/PowerShell 命令，支持 ComfyUI 路径自动映射

• NSFW 支持 —— 使用 API 密钥可完全访问 NSFW 内容（无/轻度/成熟/X 级过滤）

• 图像/视频缓存 —— 自动下载预览图到 ~/.civitai-mcp-cache/，24 小时自动清理

• 双语输出 —— 英语和俄语 (CIVITAI_MCP_LANG=ru)

• 异步且快速 —— 使用 httpx 异步客户端，在速率限制时自动重试

• 14 个工具 涵盖 100% 的 Civitai 公共 REST API v1

快速开始

从 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

星标历史

许可证

MIT