PMS Analysis Reports MCP Server

PMS analysis reports server handling maintenance reports, equipment analysis, compliance tracking, and performance metrics with ERP access for data extraction.

Configuration

The server uses environment variables for configuration. Create a .env.development file in the project root with the following variables:

# MongoDB Configuration
MONGO_URI=mongodb://username:password@host:port/database?authSource=auth_db
DB_NAME=database_name
SECONDARY_DB_URI=mongodb://username:password@host:port/database?authSource=auth_db
SECONDARY_DB_NAME=database_name
THIRD_DB_URI=mongodb://username:password@host:port/database?authSource=auth_db
THIRD_DB_NAME=database_name
COMPANY_DB_URI=mongodb://username:password@host:port/database?authSource=auth_db
COMPANY_DB_NAME=database_name

# Company Configuration
COMPANY_NAME=your_company_name

# Typesense Configuration
TYPESENSE_HOST=your_typesense_host
TYPESENSE_PORT=443
TYPESENSE_PROTOCOL=https
TYPESENSE_API_KEY=your_typesense_api_key

# API Keys (Optional)
OPENAI_API_KEY=your_openai_key
COHERE_API_KEY=your_cohere_key
PERPLEXITY_API_KEY=your_perplexity_key
LLAMA_API_KEY=your_llama_key
VENDOR_MODEL=your_vendor_model

Installation

npm install

Development

npm run dev

Build

npm run build

Start

npm start

Testing

npm test

Available Tools

The server provides the following tool categories:

Fuel Analysis Tools

• get_latest_fuel_bunker_details - Retrieves latest fuel bunker details
• get_fleet_fuel_oil_bunker_analysis - Retrieves fleet fuel oil bunker analysis
• get_fuel_oil_analysis_table_schema - Queries fuel oil analysis table schema

Lube Oil Tools

• universal_lube_oil_search - Universal search for lube oil analysis reports and data with multiple operations (overdue samples, warning analysis, latest analysis, frequency-based samples, analysis with links, schema retrieval)
• get_lube_oil_shore_analysis - Gets lube oil shore analysis status
• get_onboard_lube_analysis_form - Retrieves onboard lube oil analysis reports (TE-57)
• get_lube_oil_tank_distribution - Retrieves lube oil tank distribution and capacity details
• get_lube_oil_rob - Retrieves monthly lube oil consumption review (TE-56)

Maintenance Tools

• get_overall_maintenance_summary - Retrieves overall maintenance summary for a vessel
• get_main_engine_maintenance_summary - Gets main engine maintenance summary
• get_auxiliary_engine_maintenance_summary - Gets auxiliary engine maintenance summary
• get_purifier_maintenance_summary - Gets purifier maintenance summary
• get_compressor_maintenance_summary - Gets compressor maintenance summary
• get_critical_spares_list - Retrieves critical spares list for a vessel
• get_fleet_major_machinery_overdue_jobs - Retrieves fleet major machinery overdue jobs
• get_fleet_month_end_technical_forms_status - Gets fleet month end technical forms status

Performance Tools

• get_main_engine_performance_review - Retrieves main engine performance review
• get_main_engine_scavenge_inspection_review - Gets main engine scavenge inspection review
• get_auxiliary_engine_performance_review - Gets auxiliary engine performance review
• get_latest_engine_performance - Gets latest engine performance data
• get_historical_engine_performance - Gets historical engine performance data

PMS Tools

• get_fleet_pms_weekly_overview - Gets fleet PMS weekly overview
• get_vessel_pms_historical_data - Retrieves vessel PMS historical data
• get_month_end_consolidated_technical_report - Retrieves month end consolidated technical report

Universal Tools

• universal_pms_maintenance_search - Universal search for PMS maintenance data with multiple operations (jobs by category and status, jobs for component, jobs due within timeframe, overdue jobs, general search)
• universal_fuel_analysis_search - Universal search for fuel analysis data with multiple operations (latest fuel analysis report, historical fuel analysis data, general search)
• universal_lube_oil_search - Universal search for lube oil analysis reports and data with multiple operations (overdue samples, warning analysis, latest analysis, frequency-based samples, analysis with links, table schema)
• get_month_end_form_submission_status