Civitai MCP Server: Integrate Civitai Resources for AI Assistants

Civitai MCP Server

The Civitai MCP Server is a protocol server that provides AI assistants with comprehensive access to AI models, creators, and generated content on the Civitai platform, supporting browsing, searching, and discovering various AI models.

Artificial intelligence chatbots Image and video processing #AI models #Protocol service #Content discovery #Model search .TypeScript

rating : 2 points

downloads : 5.8K

update time : 2025-07-28

Open Site

Installation

Copy the following command to your Client for configuration

{
  "mcpServers": {
    "civitai": {
      "command": "node",
      "args": ["/path/to/civitai-mcp-server/dist/index.js"],
      "env": {
        "CIVITAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Note: Your key is sensitive information, do not share it with anyone.

🚀 Civitai MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to fully access Civitai's extensive collection of AI models, creators, and generated content. Effortlessly browse, search, and discover AI models via your preferred MCP-compatible AI assistant.

🚀 Quick Start

The Civitai MCP Server is a powerful tool that allows AI assistants to access a wide range of AI models, creators, and generated content on Civitai. Here's how you can get started quickly.

✨ Features

🔍 Model Discovery

Advanced Search: Find AI models with flexible filtering by type, creator, tags, and more.
Browse Categories: Explore models by type (Checkpoints, LoRA, ControlNet, etc.).
Popular & Trending: Discover the most downloaded and highest-rated models.
Latest Models: Stay up-to-date with newly uploaded models.
Hash Lookup: Find models by file hash for verification.

👨‍💻 Creator & Community

Creator Profiles: Browse and search for model creators.
Creator Collections: View all models from specific creators.
Tag System: Explore models through Civitai's comprehensive tagging system.

🖼️ Generated Content

Image Gallery: Browse AI-generated images with detailed metadata.
Generation Parameters: Access prompt, settings, and model information.
Community Showcase: Discover inspiring creations from the community.

📊 Model Intelligence

Detailed Model Info: Complete model specifications, versions, and files.
Version History: Track model updates and improvements.
Download URLs: Direct access to model downloads with authentication support.
Content Safety: Access scan results for pickle and virus safety.

📦 Installation

Prerequisites

Node.js 18+
npm or yarn
A Civitai API key (optional, but recommended for higher rate limits)

Quick Start

Clone the repository:

git clone https://github.com/Cicatriiz/civitai-mcp-server.git
cd civitai-mcp-server

Install dependencies:

npm install

Build the server:

npm run build

Set up your API key (optional):

export CIVITAI_API_KEY="your_api_key_here"

Run the server:

npm start

Getting a Civitai API Key

Visit Civitai API Keys.
Log in to your Civitai account.
Generate a new API key.
Copy the key and set it as an environment variable.

💻 Usage Examples

Basic Model Search

Search for SDXL LoRA models related to anime:
- Tool: search_models
- Query: "anime"
- Types: ["LORA"]
- BaseModels: ["SDXL 1.0"]

Find Popular Models

Get the most downloaded models this week:
- Tool: get_popular_models
- Period: "Week"
- Limit: 10

Model Details

Get comprehensive information about a specific model:
- Tool: get_model
- ModelId: 12345

Browse Generated Images

Explore recent AI-generated images:
- Tool: browse_images
- Sort: "Newest"
- Limit: 50
- NSFW: "None"

📚 Documentation

Available Tools

Property	Details
`search_models`	Search models with filters. Key Parameters: `query`, `types`, `sort`, `baseModels`
`get_model`	Get detailed model info. Key Parameters: `modelId`
`get_model_version`	Get version details. Key Parameters: `modelVersionId`
`get_model_version_by_hash`	Find model by file hash. Key Parameters: `hash`
`browse_images`	Browse generated images. Key Parameters: `sort`, `period`, `modelId`
`get_creators`	Search creators. Key Parameters: `query`, `limit`
`get_tags`	Browse model tags. Key Parameters: `query`, `limit`
`get_popular_models`	Most popular models. Key Parameters: `period`, `limit`
`get_latest_models`	Newest models. Key Parameters: `limit`
`get_top_rated_models`	Highest rated models. Key Parameters: `period`, `limit`
`search_models_by_tag`	Models with specific tag. Key Parameters: `tag`, `sort`
`search_models_by_creator`	Models by creator. Key Parameters: `username`, `sort`
`get_models_by_type`	Filter by model type. Key Parameters: `type`, `sort`
`get_download_url`	Get model download URL. Key Parameters: `modelVersionId`

API Reference

Model Types

Checkpoint - Full Stable Diffusion models
LORA - Low-Rank Adaptation models
TextualInversion - Embedding models
Hypernetwork - Hypernetwork models
ControlNet - ControlNet models
AestheticGradient - Aesthetic gradient models
Poses - Pose models

Sort Options

Highest Rated - Best community ratings
Most Downloaded - Most popular downloads
Newest - Recently uploaded

Time Periods

AllTime - No time restriction
Year - Past 12 months
Month - Past 30 days
Week - Past 7 days
Day - Past 24 hours

API Coverage

This MCP server implements all major Civitai API v1 endpoints:

✅ /api/v1/models - List and search models
✅ /api/v1/models/:id - Get specific model
✅ /api/v1/model-versions/:id - Get model version
✅ /api/v1/model-versions/by-hash/:hash - Get version by hash
✅ /api/v1/images - Browse images
✅ /api/v1/creators - List creators
✅ /api/v1/tags - List tags
✅ Download URLs with authentication support

Model Types Supported

Checkpoint: Full Stable Diffusion models
LORA: Low-Rank Adaptation models
TextualInversion: Textual inversion embeddings
Hypernetwork: Hypernetwork models
AestheticGradient: Aesthetic gradient models
Controlnet: ControlNet models
Poses: Pose models

Content Filtering

The server supports Civitai's content filtering system:

NSFW content levels (None, Soft, Mature, X)
Commercial use permissions
Model licensing options

Error Handling

The server includes comprehensive error handling for:

API rate limiting
Network connectivity issues
Invalid parameters
Authentication errors
Data validation

🔧 Technical Details

Project Structure

civitai-mcp-server/
├── src/
│   ├── index.ts          # Main server implementation
│   ├── civitai-client.ts # Civitai API client
│   └── types.ts          # TypeScript type definitions
├── dist/                 # Compiled JavaScript output
├── tests/                # Test files
└── docs/                 # Additional documentation

Building from Source

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run tests
npm test

# Development mode with hot reload
npm run dev

Testing

# Run comprehensive test suite
npm test

# Test specific endpoints
node test.js
node comprehensive-test.js

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

Fork the repository.
Create a feature branch.
Make your changes.
Add tests for new functionality.
Submit a pull request.

⚠️ Limitations

Rate Limiting: Civitai API has rate limits. Use an API key for higher limits.
NSFW Content: Some content may be filtered based on your account settings.
Model Availability: Some models may be temporarily unavailable or require authentication.

🛠️ Troubleshooting

Common Issues

Server won't start:

Ensure Node.js 18+ is installed.
Check that all dependencies are installed (npm install).
Verify the build completed successfully (npm run build).

API rate limiting:

Get a Civitai API key and set the CIVITAI_API_KEY environment variable.
Reduce request frequency if experiencing limits.

Models not found:

Check model ID accuracy.
Verify the model hasn't been removed or made private.
Ensure proper spelling in search queries.

📄 License

MIT License - see LICENSE file for details

🔗 Related Projects

Model Context Protocol - The MCP specification
Civitai - The AI model sharing platform
MCP Servers - Official MCP server implementations

📞 Support

🐛 Bug Reports: GitHub Issues
💡 Feature Requests: GitHub Discussions
📚 Documentation: Civitai API Reference
🔧 MCP Documentation: Model Context Protocol

search_models

Search for AI models on Civitai using various filters.

Parameters

query : string*

Description

Search query to filter models by name

Parameters

limit : number*

Description

Number of results (1 - 100, default 20)

Parameters

page : number*

Description

Pagination page number

Parameters

types : array*

Description

Filter by model type

Parameters

sort : string*

Description

Sorting method for results

Parameters

period : string*

Description

Sorting time range

Parameters

nsfw : boolean*

Description

Include NSFW content

Parameters

baseModels : array*

Description

Filter by base model type (e.g., ['SD 1.5', 'SDXL 1.0'])

get_model

Get detailed information of a specific model by ID.

Parameters

modelId : number*

Description

ID of the model to retrieve

get_model_version

Get detailed information of a specific model version.

Parameters

modelVersionId : number*

Description

ID of the model version to retrieve

get_model_version_by_hash

Get model version information by file hash.

Parameters

hash : string*

Description

Model file hash value (AutoV1, AutoV2, SHA256, CRC32 or Blake3)

browse_images

Browse AI - generated images on Civitai.

Parameters

limit : number*

Description

Number of images to return (1 - 200, default 100)

Parameters

page : number*

Description

Pagination page number

Parameters

modelId : number*

Description

Filter images of a specific model

Parameters

modelVersionId : number*

Description

Filter images of a specific model version

Parameters

postId : number*

Description

Get images of a specific post

Parameters

username : string*

Description

Filter by creator's username

Parameters

nsfw : string*

Description

NSFW content level filtering

Parameters

sort : string*

Description

Image sorting method

Parameters

period : string*

Description

Sorting time range

get_creators

Browse and search for model creators on Civitai.

Parameters

limit : number*

Description

Number of creators to return (0 - 200, default 20)

Parameters

page : number*

Description

Pagination page number

Parameters

query : string*

Description

Search query to filter creators by username

get_tags

Browse and search for model tags on Civitai.

Parameters

limit : number*

Description

Number of tags to return (1 - 200, default 20)

Parameters

page : number*

Description

Pagination page number

Parameters

query : string*

Description

Search query to filter tags by name

get_popular_models

Get the most popular/highest - downloaded models.

Parameters

period : string*

Description

Popular ranking time range (default: Week)

Parameters

limit : number*

Description

Number of models to return (default: 20)

get_latest_models

Get the latest uploaded models on Civitai.

Parameters

limit : number*

Description

Number of models to return (default: 20)

get_top_rated_models

Get the highest - rated models.

Parameters

period : string*

Description

Rating ranking time range (default: AllTime)

Parameters

limit : number*

Description

Number of models to return (default: 20)

search_models_by_tag

Search for models by a specific tag.

Parameters

tag : string*

Description

Name of the tag to search for

Parameters

limit : number*

Description

Number of models to return (default: 20)

Parameters

sort : string*

Description

Result sorting method

search_models_by_creator

Search for models by a specific creator.

Parameters

username : string*

Description

Username of the creator to search for

Parameters

limit : number*

Description

Number of models to return (default: 20)

Parameters

sort : string*

Description

Result sorting method

get_models_by_type

Filter and get models by type (Checkpoint, LORA, etc.).

Parameters

type : string*

Description

Model type to filter

Parameters

limit : number*

Description

Number of models to return (default: 20)

Parameters

sort : string*

Description

Result sorting method

get_download_url

Get the download URL of a specific model version.

Parameters

modelVersionId : number*

Description

ID of the model version to get the download URL for

Gitlab MCP Server

Certified

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

TypeScript

23.5K

5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

20.2K

5 points

Minimax MCP Server

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

TypeScript

14.8K

4.5 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご

Civitai MCP Server

Installation

Tools List

Content Details

Alternatives

Installation

🚀 Civitai MCP Server

🚀 Quick Start

✨ Features

🔍 Model Discovery

👨‍💻 Creator & Community

🖼️ Generated Content

📊 Model Intelligence

📦 Installation

Prerequisites

Quick Start

Getting a Civitai API Key

💻 Usage Examples

Basic Model Search

Find Popular Models

Model Details

Browse Generated Images

📚 Documentation

Available Tools

API Reference

Model Types

Sort Options

Time Periods

API Coverage

Model Types Supported

Content Filtering

Error Handling

🔧 Technical Details

Project Structure

Building from Source

Testing

🤝 Contributing

Development Setup

⚠️ Limitations

🛠️ Troubleshooting

Common Issues

📄 License

🔗 Related Projects

📞 Support

Alternatives