Architecture

The static structure: one process, four external dependencies, and the router that sits above the tools.

Component overview

One ASP.NET Core host serves the web client, the REST API, the SignalR hubs, the data layer, the orchestration loop, and every MCP tool class — in-process. Around it sit four external dependencies. Read it center-out from the Server.

flowchart LR
    Browser[React Client<br/>SPA at /app]
    Server[Aetherium Server<br/>ASP.NET Core .NET 10]
    PG[(PostgreSQL)]
    CDB[(ChromaDB)]
    LM[LM Studio<br/>OpenAI-compatible]
    Docker[Docker host<br/>workspace containers]

    Browser <-->|HTTP REST| Server
    Browser <-->|SignalR WebSocket| Server
    Server -->|EF Core| PG
    Server -->|HTTP| CDB
    Server -->|HTTP /v1/chat/completions| LM
    Server -->|Docker Engine API| Docker

    classDef server fill:#B87333,stroke:#2D2D2D,stroke-width:2px,color:#FFFFFF
    classDef store fill:#8FA68A,stroke:#2D2D2D,stroke-width:1.5px,color:#1A1A1A
    classDef ext fill:#C48A4E,stroke:#2D2D2D,stroke-width:1.5px,color:#1A1A1A
    classDef client fill:#D5C3B0,stroke:#2D2D2D,stroke-width:1.5px,color:#1A1A1A
    class Server server
    class PG,CDB store
    class LM,Docker ext
    class Browser client

→ §03 — System Architecture

The tool-router capability map

The Engine ships 44 tools across 12 MCP server classes. McpToolRouter sits above all of them as the single dispatch and permission point; the classes group into five capability domains.

flowchart TB
    Router[McpToolRouter<br/>schema discovery · dispatch · gates]:::router
    Router --> Exec
    Router --> Know
    Router --> Coord
    Router --> QM
    Router --> Dev

    subgraph Exec[Execution]
        WT[WorkspaceTools · 6]:::cls
        ST[ShellTools · 2]:::cls
    end
    subgraph Know[Knowledge]
        KT[KnowledgeTools · 2]:::cls
        RT[ResearchTools · 6]:::cls
    end
    subgraph Coord[Coordination]
        PT[PlanningTools · 4]:::cls
        CT[CommunicationTools · 2]:::cls
        OT[OrchestrationTools · 3]:::cls
        TT[TeamMessagingTools · 1]:::cls
    end
    subgraph QM[Quality &amp; Media]
        QT[QualityTools · 8]:::cls
        CU[ComfyUITools · 4]:::cls
        AU[AudioTools · 2]:::cls
    end
    subgraph Dev[Devices]
        DT[DeviceTools · 4]:::cls
    end

    classDef router fill:#B87333,stroke:#2D2D2D,stroke-width:2px,color:#FFFFFF
    classDef cls fill:#8FA68A,stroke:#2D2D2D,stroke-width:1.5px,color:#1A1A1A

→ §07 — MCP Architecture · full signatures in the Tool Reference