Skip to content

Architecture Overview

mdengine is a modular Python monorepo with one installable distribution and many optional runtime surfaces.

flowchart TB
    subgraph packageLayer[Python_distribution]
        Engine[mdengine_package]
        Modules[md_generator_modules]
        Extras[optional_dependency_extras]
    end
    subgraph interfaceLayer[Interfaces]
        CLI[CLI_entry_points]
        API[FastAPI_apps]
        MCP[MCP_servers]
    end
    subgraph runtimeLayer[Runtime_targets]
        Local[Local_terminal]
        Docker[Docker_compose_gateway]
        CI[GitHub_Actions]
    end
    CLI --> Modules
    API --> Modules
    MCP --> Modules
    Engine --> Modules
    Extras --> Modules
    Local --> CLI
    Docker --> API
    CI --> Engine

The dominant pattern is a modular monolith. Feature areas share packaging, test configuration, and release cadence while keeping converter logic in separate modules.