Civitai MCP Server v1.0.0

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[1.0.0] - 2025-01-26

Added

• Initial release of Civitai MCP Server
• Complete Civitai API v1 integration with 14 comprehensive tools
• Advanced model search with flexible filtering by type, creator, tags, and base models
• Browse models by popularity, rating, and recency
• Creator profiles and portfolio browsing
• Generated image gallery with metadata and generation parameters
• Model version details and hash-based lookup
• Direct download URLs with authentication support
• Content safety information (pickle and virus scan results)
• TypeScript implementation with full type safety
• Zod schema validation for robust input handling
• Comprehensive error handling with rate limiting support
• MCP protocol compliance for seamless integration
• Support for all major model types: Checkpoint, LORA, ControlNet, TextualInversion, etc.
• NSFW content filtering and commercial use permissions
• Comprehensive documentation with usage examples
• Test suite for validation and development

Tools Implemented

• search_models - Advanced model search with filters
• get_model - Detailed model information
• get_model_version - Version-specific details
• get_model_version_by_hash - Hash-based model lookup
• browse_images - Generated image gallery browsing
• get_creators - Creator profiles and search
• get_tags - Model tagging system access
• get_popular_models - Most downloaded models by time period
• get_latest_models - Recently uploaded models
• get_top_rated_models - Highest rated models by community
• search_models_by_tag - Tag-based model filtering
• search_models_by_creator - Creator-specific model browsing
• get_models_by_type - Type-based model discovery
• get_download_url - Direct model download access

Technical Features

• Node.js 18+ compatibility
• TypeScript with strict type checking
• Zod runtime validation
• Comprehensive error handling
• Rate limiting awareness
• Environment variable configuration
• MCP stdio transport
• Cross-platform support