Skip to main content
Glama
waura
by waura

Civitai MCP Server (Python FastMCP)

A Python FastMCP implementation of an MCP server for interacting with the Civitai API. Browse AI models, images, creators, and more.

Features

  • Model Search: Search AI models with various filters

  • Model Details: Get detailed information about specific models

  • Image Browsing: Browse AI-generated images

  • Creator Search: Search for model creators

  • Tag Search: Search models by tags

  • Popular/Latest/Top Rated: Get ranking information

Installation

  1. Install dependencies:

pip install -r requirements.txt
  1. Set up environment variables (optional):

cp .env.example .env # Edit .env file to set your Civitai API key

Usage

Standalone Execution

python civitai_mcp_server.py

Deploy your MCP server to Amazon Bedrock AgentCore

Deploy using Amazon Bedrock AgentCore starter toolkit

agentcore configure -e civitai_mcp_server.py --protocol MCP
agentcore launch

MCP Configuration

Add the following to your Kiro configuration file (.kiro/settings/mcp.json):

{ "mcpServers": { "civitai": { "command": "python", "args": ["path/to/civitai_mcp_server.py"], "env": { "CIVITAI_API_KEY": "your_api_key_here" }, "disabled": false, "autoApprove": [] } } }

Available Tools

  • search_models: Search models with query, type, sort filters

  • get_model: Get detailed model information by ID

  • get_model_version: Get model version details

  • get_model_version_by_hash: Get model version by file hash

  • get_popular_models: Get popular models

  • get_latest_models: Get newest models

  • get_top_rated_models: Get highest rated models

  • search_models_by_tag: Search models by tag

  • search_models_by_creator: Search models by creator

  • get_models_by_type: Filter models by type

  • get_download_url: Get download URL

Other

  • browse_images: Browse images

  • get_creators: Search creators

  • get_tags: Search tags

API Key

A Civitai API key is not required but recommended for:

  • Access to private models

  • Higher rate limits

  • Some advanced features

You can get an API key from your Civitai account settings.

Examples

# Search models search_models(query="anime", limit=10, sort="Most Downloaded") # Get specific model details get_model(model_id=12345) # Get popular LORA models get_models_by_type(type="LORA", sort="Most Downloaded", limit=5) # Browse images browse_images(limit=20, nsfw="None", sort="Newest")

Notes

  • API responses can be large

  • Use NSFW filtering options appropriately

  • Store API keys securely using environment variables

-
security - not tested
A
license - permissive license
-
quality - not tested

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/waura/civitai-mcp-server'

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