sap-ewm-io-agent

MCP server exposing SAP EWM inventory-optimization tools to Claude: live read-only queries against confirmed EWM CDS views, plus standalone inventory-math calculators (ABC/XYZ classification, safety stock, reorder point, slow-moving detection, demand forecasting).

See ARCHITECTURE.md for the confirmed service map, known data gaps, and what's currently blocked.

Status at a glance

Tool	Status
get_stock_overview	✅ Live
get_bin_utilization	✅ Live
get_storage_type_capacity	✅ Live
get_goods_movement_history	🚫 Blocked (see ARCHITECTURE.md)
abc_xyz_classify	✅ Works standalone (needs caller-supplied value/demand data)
calc_safety_stock	✅ Works standalone
calc_reorder_point	✅ Works standalone
detect_slow_moving_stock	✅ Live on-hand qty + caller-supplied movement age
forecast_demand	✅ Works standalone

Setup

npm install
cp .env.example .env
# fill in SAP_USERNAME / SAP_PASSWORD in .env

Run

npm start

Test

npm test

Runs the calc/ unit test suite (29 tests, no SAP connectivity required).

Configuration

All SAP service names, entity sets, and field definitions are confirmed from live $metadata and stored in src/config/serviceMap.json — this is the single source of truth. Tool code never hardcodes a SAP field name independently of this file; src/lib/s4hClient.js validates requested fields against it and throws a clear error if a field doesn't exist, rather than silently guessing.