How lgdimaggio/predictive-maintenance-mcp works
This is a local predictive-maintenance MCP server for reliability engineers: an assistant loads vibration data, requests spectral and fault analysis, reviews ISO severity and evidence, and can generate a diagnostic report. Separate tool families expose acquisition, analysis, diagnosis, decision support, asset history, prognostics, and reporting. The graph preserves these README capabilities; sampled source confirms the signal cache, spectral functions, diagnosis pipeline, ISO assessment, and asset-ledger roles. Some tool-to-subsystem wiring is inferred from documented responsibilities rather than inspected handler bodies.
Main entry points: server.py MCP Server · diagnostics_tools.py Diagnostic Tools · diagnosis_pipeline.py Diagnosis Pipeline · repository.py Signal Cache
Components 31
MCP Interface
- MCP Server
src/server.py - Acquisition Tools
src/mcp_tools/acquisition_tools.py - Analysis Tools
src/mcp_tools/analysis_tools.py - Diagnostic Tools
src/mcp_tools/diagnostics_tools.py - Asset Tools
src/mcp_tools/asset_tools.py - Decision Tools
src/mcp_tools/decision_support_tools.py - Prognostic Tools
src/mcp_tools/prognostics_tools.py - Report Tools
src/mcp_tools/report_tools.py
Signal Diagnostics
- Signal Cache
src/signal_acquisition/repository.py - Signal Loaders
src/signal_acquisition/loaders.py - Spectral Analysis
src/signal_processing/spectral.py - Feature Extraction
src/signal_processing/features.py - Diagnosis Pipeline
src/decision_support/diagnosis_pipeline.py - Bearing Analysis
src/diagnostics/bearing_analyzer.py - Bearing Catalog
src/diagnostics/bearing_catalog.py - ISO Severity
src/diagnostics/iso20816.py - Manual Reader
src/document_reader.py - Manual Search
src/rag.py
Asset History
- Ledger Service
src/asset_ledger/service.py - Asset Ledger
src/asset_ledger/store.py - Change Assessment
src/asset_ledger/assessment.py - Health Snapshot
src/asset_ledger/snapshot.py
Decision and Reports
- Recommendations
src/decision_support/recommendations.py - Alerts
src/decision_support/alerts.py - Trend Analysis
src/prognostics/trend_analyzer.py - RUL Estimation
src/prognostics/rul_estimator.py - Report Generation
src/report_generator.py - Report Templates
src/html_templates.py - Diagnostic Report
Other components
- Reliability Engineer
- AI Assistant
Connections 36
- Reliability Engineer → AI Assistant: requests analysis
- AI Assistant → MCP Server: invokes tools
- MCP Server → Acquisition Tools: dispatches
- MCP Server → Analysis Tools: dispatches
- MCP Server → Diagnostic Tools: dispatches
- MCP Server → Asset Tools: dispatches
- MCP Server → Decision Tools: dispatches
- MCP Server → Prognostic Tools: dispatches
- MCP Server → Report Tools: dispatches
- Acquisition Tools → Signal Cache: loads signals
- Signal Cache → Signal Loaders: reads files
- Analysis Tools → Signal Cache: gets signal
- Analysis Tools → Spectral Analysis: analyzes spectrum
- Diagnostic Tools → Diagnosis Pipeline: runs diagnosis
- Diagnosis Pipeline → Spectral Analysis: computes spectra
- Diagnosis Pipeline → Bearing Analysis: checks faults
- Diagnosis Pipeline → ISO Severity: assesses severity
- Diagnosis Pipeline → Feature Extraction: extracts features
- Bearing Analysis → Bearing Catalog: looks up specs
- Diagnostic Tools → Manual Reader: reads manuals
- Diagnostic Tools → Manual Search: searches manuals
- Diagnostic Tools → Signal Cache: gets signal
- Asset Tools → Ledger Service: manages history
- Ledger Service → Asset Ledger: reads and writes
- Ledger Service → Health Snapshot: records health
- Asset Tools → Change Assessment: compares baseline
- Change Assessment → Asset Ledger: reads history
- Decision Tools → Recommendations: requests advice
- Decision Tools → Alerts: checks alerts
- Prognostic Tools → Trend Analysis: analyzes trends
- Prognostic Tools → RUL Estimation: estimates life
- Report Tools → Report Generation: generates report
- Report Generation → Report Templates: renders with
- Report Generation → Diagnostic Report: produces
- Report Tools → Signal Cache: gets signal
- AI Assistant → Reliability Engineer: presents evidence