How danielstieger/mcpme works
McpME is an MCP server that exposes a MoWare business application through the same commands, pages, permissions, and validation used by its human interface. An MCP client calls tools at the servlet endpoint; tool handlers operate on a per-session application instance, which reports command and page state through the data-oriented toolkit. Authentication binds requests to a person, while the toolkit represents forms, tables, charts, dialogs, and generated documents. The README documents the full tool set; some implementation details are unsampled, so those relationships are shown only where the excerpts, source index, or README support them.
Main entry points: AppInstance.java App session · McpmeServlet.java MCP servlet · McpAppFactory.java Application factory · PageView.java Page state
Components 22
MCP protocol
- MCP servlet
src/main/java/org/modellwerkstatt/mcpme/McpmeServlet.java - Tool catalog
src/main/java/org/modellwerkstatt/mcpme/ToolCatalog.java - Tool handlers
src/main/java/org/modellwerkstatt/mcpme/tools/ToolHandlers.java
Application runtime
- MCP application
src/main/java/org/modellwerkstatt/mcpme/core/McpApplication.java - Application factory
src/main/java/org/modellwerkstatt/mcpme/core/McpAppFactory.java - App session
src/main/java/org/modellwerkstatt/mcpme/core/AppInstance.java - Command entries
src/main/java/org/modellwerkstatt/mcpme/core/Entry.java - Main window
src/main/java/org/modellwerkstatt/mcpme/core/McpMainWindow.java - Page state
src/main/java/org/modellwerkstatt/mcpme/core/PageView.java
Data toolkit
- Command window
src/main/java/org/modellwerkstatt/mcpme/ui/McpCommandUi.java - Form base
src/main/java/org/modellwerkstatt/mcpme/ui/McpForm.java - Table form
src/main/java/org/modellwerkstatt/mcpme/ui/McpTableForm.java - Field editor
src/main/java/org/modellwerkstatt/mcpme/ui/McpEditor.java - Chart form
src/main/java/org/modellwerkstatt/mcpme/ui/McpChartForm.java - Chart data adapters
src/main/java/org/modellwerkstatt/addons/components/support/CustomDataUxListBound.java - Series data adapter
src/main/java/org/modellwerkstatt/addons/components/support/MultiSeriesUxListBound.java
Identity and output
- Auth provider
src/main/java/org/modellwerkstatt/mcpme/auth/IMcpAuthProvider.java - Entra ID auth
src/main/java/org/modellwerkstatt/mcpme/auth/EntraIdMcpAuth.java - Token verifier
src/main/java/org/modellwerkstatt/mcpme/core/TokenVerifier.java - Print factory
src/main/java/org/modellwerkstatt/mcpme/print/McpPrintFactory.java
Other components
- MCP client
- MoWare runtime
Connections 27
- MCP client → MCP servlet: calls endpoint
README.md - MCP servlet → Tool handlers: dispatches tools
src/main/java/org/modellwerkstatt/mcpme/McpmeServlet.java - MCP servlet → Tool catalog: registers tools
src/main/java/org/modellwerkstatt/mcpme/McpmeServlet.java - MCP servlet → MCP application: configures app
src/main/java/org/modellwerkstatt/mcpme/McpmeServlet.java - MCP servlet → Auth provider: checks identity
src/main/java/org/modellwerkstatt/mcpme/McpmeServlet.java - Tool handlers → App session: executes actions
src/main/java/org/modellwerkstatt/mcpme/tools/ToolHandlers.java - MCP application → Application factory: uses factory
src/main/java/org/modellwerkstatt/mcpme/core/McpApplication.java - MCP application → App session: creates sessions
src/main/java/org/modellwerkstatt/mcpme/core/McpApplication.java - App session → Command entries: lists entries
src/main/java/org/modellwerkstatt/mcpme/core/AppInstance.java - App session → Page state: builds page state
src/main/java/org/modellwerkstatt/mcpme/core/AppInstance.java - App session → Main window: uses window
src/main/java/org/modellwerkstatt/mcpme/core/AppInstance.java - App session → Command window: uses command UI
src/main/java/org/modellwerkstatt/mcpme/core/AppInstance.java - Page state → Table form: reads table data
src/main/java/org/modellwerkstatt/mcpme/core/PageView.java - Page state → Field editor: reads field data
src/main/java/org/modellwerkstatt/mcpme/core/PageView.java - Page state → Chart form: reads chart data
src/main/java/org/modellwerkstatt/mcpme/core/PageView.java - Command window → Form base: holds content
src/main/java/org/modellwerkstatt/mcpme/ui/McpCommandUi.java - Table form → Form base: extends base
src/main/java/org/modellwerkstatt/mcpme/ui/McpTableForm.java - Chart form → Form base: extends base
src/main/java/org/modellwerkstatt/mcpme/ui/McpChartForm.java - Chart form → Chart data adapters: reads pie data
src/main/java/org/modellwerkstatt/mcpme/ui/McpChartForm.java - Chart form → Series data adapter: reads series data
src/main/java/org/modellwerkstatt/mcpme/ui/McpChartForm.java - Application factory → Command window: creates UI
src/main/java/org/modellwerkstatt/mcpme/core/McpAppFactory.java - Application factory → Form base: creates forms
src/main/java/org/modellwerkstatt/mcpme/core/McpAppFactory.java - Entra ID auth → Auth provider: implements provider
src/main/java/org/modellwerkstatt/mcpme/auth/EntraIdMcpAuth.java - Token verifier → Auth provider: uses provider
src/main/java/org/modellwerkstatt/mcpme/core/TokenVerifier.java - Print factory → Main window: uses window
src/main/java/org/modellwerkstatt/mcpme/print/McpPrintFactory.java - Application factory → MoWare runtime: implements toolkit
README.md - App session → MoWare runtime: runs commands
README.md