How antoinebou12/uml-mcp works
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: server.py MCP Server · diagram_service.py Diagram Service · diagram_tools.py Diagram Tools · routes.py Admin API
Components 21
MCP Runtime
- MCP Server
mcp_core/core/server.py - Diagram Tools
mcp_core/tools/diagram_tools.py - Plugin Loader
mcp_core/plugins/loader.py
Diagram Workflow
- Input Validation
mcp_core/core/diagram_validation.py - Diagram Service
mcp_core/core/diagram_service.py - Diagram Rendering
mcp_core/core/diagram_rendering.py - Kroki Renderers
tools/kroki/kroki.py - Render Cache
mcp_core/core/render_cache.py - Chat and Image Output
mcp_core/core/chat_packet.py - Diagram Catalog
mcp_core/core/diagram_catalog.py
Agent Interfaces
- Diagram Prompts
mcp_core/prompts/diagram_prompts.py - Diagram Resources
mcp_core/resources/diagram_resources.py - AG-UI Events
mcp_core/core/agui.py
Admin Console
- Admin API
mcp_core/admin/routes.py - Settings Service
mcp_core/admin/settings_service.py - Kroki Playground
mcp_core/admin/kroki_routes.py - Admin Web Console
frontend/src/App.tsx
Security and Operations
- Bearer Authentication
mcp_core/auth/mcp_auth.py - Audit and Metrics
mcp_core/observability/audit.py
Other components
- AI Client
- Kroki Service
Connections 21
- AI Client → MCP Server: requests tools
README.md - MCP Server → Diagram Tools: registers tools
mcp_core/core/server.py - Diagram Tools → Input Validation: validates input
mcp_core/tools/diagram_tools.py - Diagram Tools → Diagram Service: requests generation
mcp_core/tools/diagram_tools.py - Diagram Service → Diagram Rendering: generates diagram
mcp_core/core/diagram_service.py - Diagram Service → Render Cache: reads and writes
mcp_core/core/diagram_service.py - Diagram Rendering → Kroki Renderers: renders source
mcp_core/core/utils.py - Kroki Renderers → Kroki Service: sends render request
- Diagram Service → Chat and Image Output: builds display output
mcp_core/core/diagram_service.py - Diagram Tools → Diagram Catalog: lists diagram types
mcp_core/tools/diagram_tools.py - MCP Server → Diagram Prompts: registers prompts
mcp_core/core/server.py - MCP Server → Diagram Resources: registers resources
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
mcp_core/admin/routes.py - Admin API → Kroki Playground: adds Kroki routes
mcp_core/admin/routes.py - Kroki Playground → Diagram Service: renders playground
mcp_core/admin/kroki_routes.py - Bearer Authentication → MCP Server: protects requests
- Admin API → Audit and Metrics: records operations
mcp_core/admin/routes.py - MCP Server → Plugin Loader: loads plugins
mcp_core/core/server.py - Plugin Loader → Kroki Renderers: routes plugin types