How dzentec/sia_mkp works
MKP-R turns maritime PDFs, EPUBs, and DOCX files into signed knowledge bookpacks, then serves onboard search and telemetry-matched rules to an MCP-connected yacht adviser. The documented builder stages and server capabilities are represented; source excerpts are partial, so uncertain internal wiring is omitted. The README describes yacht, voyage, and personal content tiers as stubs.
Main entry points: pipeline.py Build orchestrator · server.py MCP tools · exporter.py Bookpack export · parsers Document parsing
Components 27
Offline bookpack builder
- Build orchestrator
src/mkp_builder/pipeline.py - Document parsing
src/mkp_builder/parsers - OCR processing
src/mkp_builder/ocr.py - Image filtering
src/mkp_builder/vlm - VLM annotation
src/mkp_builder/vlm/annotator.py - Visual verification
src/mkp_builder/vlm/verifier.py - Section chunking
src/mkp_builder/chunker.py - Triplet extraction
src/mkp_builder/triplets.py - Claims extraction
src/mkp_builder/extract/claims.py - Rule synthesis
src/mkp_builder/synthesize/synthesize.py - Rule review
src/mkp_builder/review.py - Guardrail compilation
src/mkp_builder/compile/guardrails.py - Pack signing
src/mkp_builder/export/signer.py - Bookpack export
src/mkp_builder/exporter.py
Onboard knowledge server
- Pack import
src/mkp_server/importer.py - Storage lifecycle
src/mkp_server/lifecycle.py - Pack storage
src/mkp_server/storage.py - Hybrid search
src/mkp_server/search.py - Knowledge graph
src/mkp_server/graph.py - Rule matching
src/mkp_server/rules_store.py - MCP tools
src/mkp_server/server.py
Advisor experience
- SIA Advisor
Other components
- Maritime documents
- Signed bookpack
- Skipper
- Yacht telemetry
- Ollama models
Connections 26
- Maritime documents → Build orchestrator: provides inputs
- Build orchestrator → Document parsing: parses via
- Document parsing → OCR processing: uses when needed
- Build orchestrator → Image filtering: filters figures
- Build orchestrator → VLM annotation: annotates figures
- Build orchestrator → Visual verification: verifies annotations
- Build orchestrator → Section chunking: chunks content
- Build orchestrator → Triplet extraction: extracts triplets
- Build orchestrator → Claims extraction: extracts claims
- Build orchestrator → Rule synthesis: synthesizes rules
- Build orchestrator → Rule review: supports review
- Build orchestrator → Guardrail compilation: compiles guardrails
- Build orchestrator → Bookpack export: exports content
- Bookpack export → Pack signing: signs pack
- Bookpack export → Signed bookpack: writes
- Ollama models → Build orchestrator: serves inference
- Signed bookpack → Pack import: transfers to
- Pack import → Storage lifecycle: applies update
- Storage lifecycle → Pack storage: manages tiers
- Pack storage → MCP tools: provides active data
- MCP tools → Hybrid search: indexes and queries
- MCP tools → Knowledge graph: serves graph tools
- MCP tools → Rule matching: loads and queries
- Skipper → SIA Advisor: asks questions
- SIA Advisor → MCP tools: requests knowledge
- Yacht telemetry → SIA Advisor: informs advice