mcp-inventory 1.4.0

Inventory & Warehouse MCP server — stock management, BOM, locations, transfers, reorder alerts, lot tracking, reservations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171

use serde::{Deserialize, Serialize};
use serde_json::Value;

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Item {
    pub sku: String,
    pub name: String,
    pub category: String,
    pub unit: String, // each, kg, litre, box, pallet
    pub reorder_point: f64,
    pub reorder_qty: f64,
    pub cost: f64,
    pub currency: String,
    pub attributes: Value,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Location {
    pub id: String,
    pub name: String,
    pub location_type: String, // warehouse, zone, aisle, rack, bin, staging, dock
    pub parent_id: Option<String>,
    pub address: Option<String>,
    pub capacity_units: Option<f64>,   // max units this location can hold
    pub capacity_weight_kg: Option<f64>, // max weight
    pub capacity_volume_m3: Option<f64>, // max volume
    pub used_units: f64,
    pub used_weight_kg: f64,
    pub used_volume_m3: f64,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct PickOrder {
    pub id: String,
    pub status: String, // pending, picking, packed, shipped, cancelled
    pub order_reference: String,
    pub lines: Vec<PickLine>,
    pub assigned_to: Option<String>,
    pub wave_id: Option<String>,
    pub created_at: String,
    pub updated_at: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct PickLine {
    pub sku: String,
    pub quantity: f64,
    pub from_location: String,
    pub picked_qty: f64,
    pub status: String, // pending, picked, short
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct PutawayRule {
    pub id: String,
    pub category: String,       // item category this rule applies to
    pub target_zone: String,    // preferred zone/location
    pub priority: i32,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct CycleCount {
    pub id: String,
    pub location_id: String,
    pub status: String, // scheduled, in_progress, completed
    pub scheduled_date: String,
    pub counted_by: Option<String>,
    pub discrepancies: Vec<Value>,
    pub completed_at: Option<String>,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Wave {
    pub id: String,
    pub name: String,
    pub status: String, // planning, released, in_progress, completed
    pub pick_ids: Vec<String>,
    pub priority: String,
    pub created_at: String,
    pub released_at: Option<String>,
    pub completed_at: Option<String>,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct BarcodeLabel {
    pub id: String,
    pub barcode_type: String, // sku, location, lot, shipment, receipt, serial, rfid
    pub entity_id: String,
    pub barcode_format: String, // code128, ean13, qr, datamatrix, rfid_epc
    pub barcode_value: String,
    pub label_text: Vec<String>,
    pub generated_at: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct SerializedItem {
    pub serial_number: String,
    pub sku: String,
    pub status: String, // in_stock, reserved, shipped, returned, scrapped
    pub location_id: String,
    pub lot_number: Option<String>,
    pub manufacture_date: Option<String>,
    pub expiry_date: Option<String>,
    pub rfid_tag: Option<String>,
    pub qr_code: Option<String>,
    pub history: Vec<SerialEvent>,
    pub metadata: Value,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct SerialEvent {
    pub event_type: String, // received, moved, picked, shipped, returned, scrapped
    pub location: String,
    pub actor: String,
    pub timestamp: String,
    pub reference: Option<String>,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct RfidTag {
    pub epc: String, // Electronic Product Code (96-bit hex)
    pub serial_number: Option<String>,
    pub sku: Option<String>,
    pub location_id: String,
    pub last_read_at: String,
    pub read_count: u32,
    pub status: String, // active, lost, decommissioned
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct StockLevel {
    pub sku: String,
    pub location_id: String,
    pub quantity: f64,
    pub reserved: f64,
    pub lot_number: Option<String>,
    pub expiry_date: Option<String>,
    pub updated_at: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct StockMovement {
    pub id: String,
    pub movement_type: String, // receive, issue, transfer, adjust, return
    pub sku: String,
    pub quantity: f64,
    pub from_location: Option<String>,
    pub to_location: Option<String>,
    pub reference: String,
    pub actor: String,
    pub lot_number: Option<String>,
    pub timestamp: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct BomEntry {
    pub parent_sku: String,
    pub component_sku: String,
    pub quantity: f64,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Reservation {
    pub id: String,
    pub sku: String,
    pub location_id: String,
    pub quantity: f64,
    pub reference: String, // order_id, work_order_id
    pub expires_at: Option<String>,
    pub created_at: String,
}