# antoinebou12/uml-mcp architecture

> Architecture diagram of the GitHub repository antoinebou12/uml-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antoinebou12/uml-mcp
- Repository: https://github.com/antoinebou12/uml-mcp

## Overview

UML-MCP lets an AI client request diagram discovery, validation, rendering, and delivery through MCP; its README also describes AG-UI/OpenUI integration and an administrative console. The graph preserves those product branches, plus optional enterprise authentication and observability. Source excerpts and the SOURCE INDEX support the main server, tool, and admin relationships; several frontend/API and external-service connections are documented only at a high level or were not sampled, so they are omitted or marked unverified.

Main entry points: [`mcp_core/core/server.py`](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/server.py) (MCP Server), [`mcp_core/core/diagram_service.py`](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/diagram_service.py) (Diagram Service), [`mcp_core/tools/diagram_tools.py`](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/tools/diagram_tools.py) (Diagram Tools), [`mcp_core/admin/routes.py`](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/admin/routes.py) (Admin API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["MCP Runtime"]
  node_mcp_server["MCP Server<br/>[server.py]"]
  node_diagram_tools["Diagram Tools<br/>[diagram_tools.py]"]
  node_plugin_loader["Plugin Loader<br/>[loader.py]"]
end

subgraph group_diagrams["Diagram Workflow"]
  node_validation["Input Validation"]
  node_diagram_service["Diagram Service<br/>[diagram_service.py]"]
  node_rendering["Diagram Rendering"]
  node_kroki["Kroki Renderers<br/>[kroki.py]"]
  node_render_cache["Render Cache<br/>[render_cache.py]"]
  node_delivery["Chat and Image Output<br/>[chat_packet.py]"]
  node_catalog["Diagram Catalog<br/>[diagram_catalog.py]"]
end

subgraph group_agent["Agent Interfaces"]
  node_prompts["Diagram Prompts<br/>[diagram_prompts.py]"]
  node_resources["Diagram Resources"]
  node_agui["AG-UI Events<br/>[agui.py]"]
end

subgraph group_admin["Admin Console"]
  node_admin_api["Admin API<br/>[routes.py]"]
  node_admin_settings["Settings Service"]
  node_kroki_admin["Kroki Playground<br/>[kroki_routes.py]"]
  node_console_ui["Admin Web Console<br/>[App.tsx]"]
end

subgraph group_operations["Security and Operations"]
  node_enterprise_auth["Bearer Authentication<br/>[mcp_auth.py]"]
  node_audit["Audit and Metrics<br/>[audit.py]"]
end

node_client(("AI Client"))
node_kroki_service["Kroki Service"]

node_client -->|"requests tools"| node_mcp_server
node_mcp_server -->|"registers tools"| node_diagram_tools
node_diagram_tools -->|"validates input"| node_validation
node_diagram_tools -->|"requests generation"| node_diagram_service
node_diagram_service -->|"generates diagram"| node_rendering
node_diagram_service -->|"reads and writes"| node_render_cache
node_rendering -->|"renders source"| node_kroki
node_kroki -.->|"sends render request"| node_kroki_service
node_diagram_service -->|"builds display output"| node_delivery
node_diagram_tools -->|"lists diagram types"| node_catalog
node_mcp_server -->|"registers prompts"| node_prompts
node_mcp_server -->|"registers resources"| node_resources
node_mcp_server -.->|"serves event interface"| node_agui
node_console_ui -.->|"uses console API"| node_admin_api
node_admin_api -->|"reads and saves"| node_admin_settings
node_admin_api -->|"adds Kroki routes"| node_kroki_admin
node_kroki_admin -->|"renders playground"| node_diagram_service
node_enterprise_auth -.->|"protects requests"| node_mcp_server
node_admin_api -->|"records operations"| node_audit
node_mcp_server -->|"loads plugins"| node_plugin_loader
node_plugin_loader -.->|"routes plugin types"| node_kroki

click node_mcp_server "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/server.py"
click node_diagram_tools "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/tools/diagram_tools.py"
click node_validation "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/diagram_validation.py"
click node_diagram_service "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/diagram_service.py"
click node_rendering "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/diagram_rendering.py"
click node_kroki "https://github.com/antoinebou12/uml-mcp/blob/main/tools/kroki/kroki.py"
click node_render_cache "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/render_cache.py"
click node_delivery "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/chat_packet.py"
click node_catalog "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/diagram_catalog.py"
click node_prompts "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/prompts/diagram_prompts.py"
click node_resources "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/resources/diagram_resources.py"
click node_agui "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/agui.py"
click node_admin_api "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/admin/routes.py"
click node_admin_settings "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/admin/settings_service.py"
click node_kroki_admin "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/admin/kroki_routes.py"
click node_console_ui "https://github.com/antoinebou12/uml-mcp/blob/main/frontend/src/App.tsx"
click node_enterprise_auth "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/auth/mcp_auth.py"
click node_audit "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/observability/audit.py"
click node_plugin_loader "https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/plugins/loader.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp_server,node_diagram_tools,node_plugin_loader,node_client toneBlue
class node_validation,node_diagram_service,node_rendering,node_kroki,node_render_cache,node_delivery,node_catalog toneAmber
class node_prompts,node_resources,node_agui toneMint
class node_admin_api,node_admin_settings,node_kroki_admin,node_console_ui toneRose
class node_enterprise_auth,node_audit,node_kroki_service toneIndigo
```

## Components

### MCP Runtime

- [MCP Server](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/server.py): `mcp_core/core/server.py`
- [Diagram Tools](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/tools/diagram_tools.py): `mcp_core/tools/diagram_tools.py`
- [Plugin Loader](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/plugins/loader.py): `mcp_core/plugins/loader.py`

### Diagram Workflow

- [Input Validation](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/diagram_validation.py): `mcp_core/core/diagram_validation.py`
- [Diagram Service](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/diagram_service.py): `mcp_core/core/diagram_service.py`
- [Diagram Rendering](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/diagram_rendering.py): `mcp_core/core/diagram_rendering.py`
- [Kroki Renderers](https://github.com/antoinebou12/uml-mcp/blob/main/tools/kroki/kroki.py): `tools/kroki/kroki.py`
- [Render Cache](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/render_cache.py): `mcp_core/core/render_cache.py`
- [Chat and Image Output](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/chat_packet.py): `mcp_core/core/chat_packet.py`
- [Diagram Catalog](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/diagram_catalog.py): `mcp_core/core/diagram_catalog.py`

### Agent Interfaces

- [Diagram Prompts](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/prompts/diagram_prompts.py): `mcp_core/prompts/diagram_prompts.py`
- [Diagram Resources](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/resources/diagram_resources.py): `mcp_core/resources/diagram_resources.py`
- [AG-UI Events](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/agui.py): `mcp_core/core/agui.py`

### Admin Console

- [Admin API](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/admin/routes.py): `mcp_core/admin/routes.py`
- [Settings Service](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/admin/settings_service.py): `mcp_core/admin/settings_service.py`
- [Kroki Playground](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/admin/kroki_routes.py): `mcp_core/admin/kroki_routes.py`
- [Admin Web Console](https://github.com/antoinebou12/uml-mcp/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Security and Operations

- [Bearer Authentication](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/auth/mcp_auth.py): `mcp_core/auth/mcp_auth.py`
- [Audit and Metrics](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/observability/audit.py): `mcp_core/observability/audit.py`

### Other components

- **AI Client**
- **Kroki Service**

## Connections

- AI Client → MCP Server: requests tools (evidence: `README.md`)
- MCP Server → Diagram Tools: registers tools (evidence: `mcp_core/core/server.py`)
- Diagram Tools → Input Validation: validates input (evidence: `mcp_core/tools/diagram_tools.py`)
- Diagram Tools → Diagram Service: requests generation (evidence: `mcp_core/tools/diagram_tools.py`)
- Diagram Service → Diagram Rendering: generates diagram (evidence: `mcp_core/core/diagram_service.py`)
- Diagram Service → Render Cache: reads and writes (evidence: `mcp_core/core/diagram_service.py`)
- Diagram Rendering → Kroki Renderers: renders source (evidence: `mcp_core/core/utils.py`)
- Kroki Renderers → Kroki Service: sends render request
- Diagram Service → Chat and Image Output: builds display output (evidence: `mcp_core/core/diagram_service.py`)
- Diagram Tools → Diagram Catalog: lists diagram types (evidence: `mcp_core/tools/diagram_tools.py`)
- MCP Server → Diagram Prompts: registers prompts (evidence: `mcp_core/core/server.py`)
- MCP Server → Diagram Resources: registers resources (evidence: `mcp_core/core/server.py`)
- MCP Server → AG-UI Events: serves event interface
- Admin Web Console → Admin API: uses console API
- Admin API → Settings Service: reads and saves (evidence: `mcp_core/admin/routes.py`)
- Admin API → Kroki Playground: adds Kroki routes (evidence: `mcp_core/admin/routes.py`)
- Kroki Playground → Diagram Service: renders playground (evidence: `mcp_core/admin/kroki_routes.py`)
- Bearer Authentication → MCP Server: protects requests
- Admin API → Audit and Metrics: records operations (evidence: `mcp_core/admin/routes.py`)
- MCP Server → Plugin Loader: loads plugins (evidence: `mcp_core/core/server.py`)
- Plugin Loader → Kroki Renderers: routes plugin types
