civitai

The CivitaI MCP Server exposes a rich set of tools that integrate Civitai’s model catalog into your MCP-enabled assistant. It provides endpoints and tools for discovering models, viewing creator profiles, exploring images, and retrieving detailed model information and download URLs. Core capabilities include searching models with filters (type, creator, tags), retrieving model versions, browsing generated images with metadata, and fetching download URLs with optional authentication. You can invoke tools like search_models, get_model, get_model_version, browse_images, get_creators, get_tags, and get_download_url to build conversational flows that help users find, compare, and securely obtain model assets from Civitai.

To use the server, connect your MCP client to the CivitaI server using the standard stdio transport and point it at the server’s node entry file. When configured with a CIVITAI_API_KEY, the server can achieve higher rate limits and access restricted endpoints. Typical interactions include querying for models by keyword, filtering by type (e.g., LORA, Checkpoint, ControlNet), fetching a specific model’s details, or retrieving the latest and most popular models. The available tools are documented in the server’s API reference within the README and are designed to be composed into natural language prompts or scripted workflows in your assistant.

Prerequisites

• Node.js 18+ (LTS) installed on your system
• npm or yarn for package management
• Optional: a CivitaI API key to increase rate limits (set CIVITAI_API_KEY in your environment)

Install and run

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Build the server (TypeScript to JavaScript):

npm run build

4. (Optional) Set up your CivitaI API key:

export CIVITAI_API_KEY="your_api_key_here"

5. Run the server:

npm start

6. If you’re using a client configuration, point it to the server entry:

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

Tips and considerations:

• Keep your CIVITAI_API_KEY secure; avoid committing it to version control.
• The server exposes a full API coverage for Civitai endpoints; ensure you are compliant with rate limits and licensing.
• If you encounter API rate limiting, switch to an API key or adjust tool usage cadence.
• When building from source, ensure TypeScript compilation completes successfully before running the server.
• The server supports content filtering options consistent with CivitaI's policies; consider enabling appropriate filters for your use case.
• For debugging, use npm run dev for development mode with hot reload and run the test suite with npm test.