# gerred/mcp-server-replicate architecture

> Architecture diagram of the GitHub repository gerred/mcp-server-replicate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gerred/mcp-server-replicate
- Repository: https://github.com/gerred/mcp-server-replicate

## Overview

Key Components to Include:

##### Core Server Components
- Replicate Client component that interfaces with Replicate's API
- Server module (server.py) as the main entry point

##### Model Layer
- Collection Model
- Hardware Model
- Prediction Model
- Webhook Model
- Base Model class

##### Templates System
- Parameters Templates:
- Common Configs
- ControlNet
- LLaMA
- Stable Diffusion
- Prompts Templates:
- ControlNet
- Image-to-Image
- Text Generation
- Text-to-Image

##### Tools Layer
Utility components:
- Collection Tools
- Hardware Tools
- Model Tools
- Prediction Tools
- Webhook Tools

**┌─────────────────────────────────────────────────────┐**
- Client Applications                 │
- (Claude Desktop / Other Clients)          │
- ┘
- ↕ HTTP/WebSocket
**┌─────────────────────────────────────────────────────┐**
- FastMCP Server                     │
- ┬────────────────┬─────────────────┤
- Template System│   Core Server  │    Tools Layer   │
- ┌───────────┐  │  ┌─────────┐  │  ┌───────────┐  │
- Parameters │  │  │  Server │  │  │Collection │  │
- TemplateS  │──┼─▶│  Module │◀─┼──│  Tools   │  │
- ┘  │  └─────────┘  │  └───────────┘  │
- ┌───────────┐  │  ┌─────────┐  │  ┌───────────┐  │
- Prompts   │  │  │Replicate│  │  │  Model    │  │
- Templates  │──┼─▶│ Client  │◀─┼──│  Tools    │  │
- ┘  │  └─────────┘  │  └───────────┘  │
- ┴────────────────┴─────────────────┤
- Model Layer                       │
- Collection│Hardware│Prediction│Webhook│Base      │
- ┘
- ↕ HTTP
**┌─────────────────────────────────────────────────────┐**
- Replicate API                       │
- ┘

- Use blue for core server components
- Green for template system
- Yellow for tools layer
- Purple for model layer
- Gray for external systems

Important Elements to Highlight:
##### Data Flow
- Bidirectional communication between client and server
- Webhook notifications flow
- Template processing flow

##### Integration Points
- Replicate API connection
- Client application interfaces
- Webhook endpoints

##### Key Features
- Resource-based image generation
- Real-time updates via subscriptions
- Template-driven configuration
- Model discovery and selection

##### Security Layer
- API key management
- Environment configuration

Remember to:
- Version information
- Technology stack annotations (Python 3.11+, FastMCP, etc.)
- Configuration dependencies (.env, smithery.yaml)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Systems
    Client["Client Applications"]
    ReplicateAPI["Replicate API"]

    %% Core Server Components
    subgraph Server["FastMCP Server"]
        ServerModule["Server Module"]:::core
        click ServerModule "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/server.py"
        ReplicateClient["Replicate Client"]:::core
        click ReplicateClient "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/replicate_client.py"

        %% Template System
        subgraph Templates["Template System"]
            subgraph ParametersTemplates["Parameters Templates"]
                CommonConfigs["Common Configs"]:::template
                click CommonConfigs "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/templates/parameters/common_configs.py"
                ControlNetParams["ControlNet Params"]:::template
                click ControlNetParams "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/templates/parameters/controlnet.py"
                LLaMA["LLaMA"]:::template
                click LLaMA "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/templates/parameters/llama.py"
                StableDiffusion["Stable Diffusion"]:::template
                click StableDiffusion "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/templates/parameters/stable_diffusion.py"
            end

            subgraph PromptsTemplates["Prompts Templates"]
                ControlNetPrompts["ControlNet"]:::template
                click ControlNetPrompts "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/templates/prompts/controlnet.py"
                ImageToImage["Image-to-Image"]:::template
                click ImageToImage "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/templates/prompts/image_to_image.py"
                TextGeneration["Text Generation"]:::template
                click TextGeneration "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/templates/prompts/text_generation.py"
                TextToImage["Text-to-Image"]:::template
                click TextToImage "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/templates/prompts/text_to_image.py"
            end
        end

        %% Tools Layer
        subgraph Tools["Tools Layer"]
            CollectionTools["Collection Tools"]:::tool
            click CollectionTools "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/tools/collection_tools.py"
            HardwareTools["Hardware Tools"]:::tool
            click HardwareTools "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/tools/hardware_tools.py"
            ModelTools["Model Tools"]:::tool
            click ModelTools "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/tools/model_tools.py"
            PredictionTools["Prediction Tools"]:::tool
            click PredictionTools "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/tools/prediction_tools.py"
            WebhookTools["Webhook Tools"]:::tool
            click WebhookTools "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/tools/webhook_tools.py"
        end

        %% Model Layer
        subgraph Models["Model Layer"]
            CollectionModel["Collection Model"]:::model
            click CollectionModel "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/models/collection.py"
            HardwareModel["Hardware Model"]:::model
            click HardwareModel "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/models/hardware.py"
            PredictionModel["Prediction Model"]:::model
            click PredictionModel "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/models/prediction.py"
            WebhookModel["Webhook Model"]:::model
            click WebhookModel "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/models/webhook.py"
            BaseModel["Base Model"]:::model
            click BaseModel "https://github.com/gerred/mcp-server-replicate/blob/main/src/mcp_server_replicate/models/model.py"
        end
    end

    %% Connections
    Client <--> ServerModule
    ServerModule <--> ReplicateClient
    ReplicateClient <--> ReplicateAPI
    
    %% Internal Connections
    ServerModule --> Templates
    ServerModule --> Tools
    ServerModule --> Models
    Tools --> Models
    Templates --> Tools

    %% Styling
    classDef external fill:#gray,stroke:#333,stroke-width:2px
    classDef core fill:#3498db,stroke:#2980b9,stroke-width:2px
    classDef template fill:#2ecc71,stroke:#27ae60,stroke-width:2px
    classDef tool fill:#f1c40f,stroke:#f39c12,stroke-width:2px
    classDef model fill:#9b59b6,stroke:#8e44ad,stroke-width:2px

    class Client,ReplicateAPI external
    class ServerModule,ReplicateClient core
    class CommonConfigs,ControlNetParams,LLaMA,StableDiffusion,ControlNetPrompts,ImageToImage,TextGeneration,TextToImage template
    class CollectionTools,HardwareTools,ModelTools,PredictionTools,WebhookTools tool
    class CollectionModel,HardwareModel,PredictionModel,WebhookModel,BaseModel model
```
