SIOMS MCP服务器
智能库存和订单管理系统(SIOMS)的模型上下文协议(MCP)服务器,为人工智能助手提供全面的库存管理工具。
概述
此MCP服务器使人工智能助手能够与SIOMS API交互,以执行高级库存管理操作。它提供了15多种强大的工具,用于检查库存水平、管理库存、分析仓库绩效和维护产品目录。
特性
🏪 核心库存管理
- 实时库存检查 所有仓库
- 低库存警报 提供重新订购建议
- 全面的库存报告 通过分析
- 跨仓库库存可见性
📦 库存管理操作
- 添加库存 带验证的仓库
- 移除库存 进行安全检查
- 更新库存 精确数量
- 批量操作 支持
📋 产品管理
- 产品目录 使用过滤进行浏览
- 详细的产品分析 包括库存分配
- 新产品创建 通过验证
- 价格分类 和分析
🏬 仓库分析
- 仓库性能 指标
- 健康评分 系统(0-100刻度)
- 分布分析 跨地点
- 可采取行动的建议
安装和设置
1.先决条件
- .NET 9.0 SDK
- 正在运行SIOMS API实例
- 有效的SIOMS用户凭据
2.配置服务器
编辑 appsettings.json 与您的SIOMS API详细信息:```json
{
"SiomsApi": {
"BaseUrl": "http://localhost:5000",
"Username": "your_username",
"Password": "your_password",
"TokenRefreshMinutes": 50,
"TimeoutSeconds": 30
}
}
### 3.构建和运行```bash
# Navigate to the project directory
cd sioms-mcp
# Restore dependencies
dotnet restore
# Build the project
dotnet build
# Run the MCP server
dotnet run
可用的MCP工具
🔍 库存工具
check_warehouse_inventory
通过详细分析获得特定仓库的完整库存。
参数:
warehouseId(int):要检查的仓库IDincludeDetails(bool):包括详细的产品信息
示例响应:```json
{
"WarehouseId": 1,
"TotalItems": 150,
"TotalValue": 45750.50,
"LowStockItems": 12,
"Summary": {
"InStock": 138,
"OutOfStock": 12,
"NeedsReorder": 12
}
}
#### `check_product_stock`
检查所有仓库中产品的库存水平。
**参数:**
- `productId` (int):要检查的产品ID
#### `get_low_stock_items`
查找低于再订购级别的产品,并提供再订购建议。
**参数:**
- `warehouseId` (int):要检查的仓库
#### `get_total_stock`
获取所有仓库中产品的总库存。
**参数:**
- `productId` (int):产品ID
### ⚡ 库存管理工具
#### `add_stock`
通过验证和报告将库存添加到仓库。
**参数:**
- `warehouseId` (int):目标仓库
- `productId` (int):要添加库存的产品
- `quantity` (int):要添加的数量(必须为正)
#### `remove_stock`
通过安全检查和低库存警告删除库存。
**参数:**
- `warehouseId` (int):源仓库
- `productId` (int):要移除库存的产品
- `quantity` (int):要删除的数量
#### `update_stock`
通过变更跟踪设置准确的库存数量。
**参数:**
- `warehouseId` (int):目标仓库
- `productId` (int):要更新的产品
- `newQuantity` (int):新的精确数量
### 📋 产品管理工具
#### `get_products`
获取所有产品的可选库存信息和分析。
**参数:**
- `includeStockInfo` (bool):包括实时库存水平
#### `get_product_details`
获取全面的产品信息,包括分销分析。
**参数:**
- `productId` (int):产品ID以获取详细信息
#### `create_product`
在验证和设置指导下创建新产品。
**参数:**
- `name` (string):产品名称
- `sku` (字符串):唯一SKU
- `price` (十进制):产品价格
- `reorderLevel` (int):最低库存水平(默认值:10)
### 🏬 仓库管理工具
#### `get_warehouses`
获取所有仓库的库存汇总和状态分析。
**参数:**
- `includeInventorySummary` (bool):包括详细的库存数据
#### `get_warehouse_details`
获得全面的仓库分析,包括健康评分和建议。
**参数:**
- `warehouseId` (int):用于详细分析的仓库ID
## 建筑
### 项目结构```
sioms-mcp/
├── src/
│ ├── Models/ # Data models matching SIOMS API
│ ├── Services/ # Business logic and API communication
│ ├── Tools/ # MCP tool implementations
│ ├── Constants/ # API endpoints and configuration
│ └── Extensions/ # Service registration extensions
├── appsettings.json # Configuration file
├── Program.cs # Application entry point
└── README.md # This documentation
关键组件
SiomsApiService
用于与以下对象进行SIOMS API通信的HTTP客户端包装:
- 自动身份验证处理
- 请求/响应日志记录
- 错误处理和重试逻辑
- JSON序列化
AuthService
JWT令牌管理:
- 自动令牌刷新
- 线程安全操作
- 令牌验证
- 凭据管理
工具类
InventoryTools:库存检查和库存分析StockManagementTools:库存修改操作ProductTools:产品目录管理WarehouseTools:仓库分析和管理
配置选项
| 设置 | 说明 | 默认值 | 必填 |
|---|---|---|---|
SiomsApi:BaseUrl |
API基本URL | http://localhost:5000 |
✅ |
SiomsApi:Username |
SIOMS用户名 | - | ✅ |
SiomsApi:Password |
SIOMS密码 | - | ✅ |
SiomsApi:TokenRefreshMinutes |
令牌刷新间隔 | 50 |
❌ |
SiomsApi:TimeoutSeconds |
HTTP超时 | 30 |
❌ |
错误处理
MCP服务器包括全面的错误处理:
- 身份验证错误:使用凭据验证自动重试
- 网络问题:超时处理和连接重试
- API错误:带有上下文的详细错误消息
- 验证错误:使用有用消息进行输入验证
- 日志记录:结构化日志记录到stderr以实现MCP兼容性
安全功能
- 安全的凭证存储 在配置中
- JWT令牌自动刷新 到期前
- 输入验证 所有参数
- API速率限制 尊重
- 连接安全 支持HTTPS
性能优化
- HTTP连接池 用于API调用
- 异步/等待 始终保持可扩展性
- 高效的JSON序列化 关于Newtonsoft我是
- 智能缓存 用于身份验证令牌
- 并行操作 在有益的地方
故障排除
常见问题
❌ “配置验证失败”
- 确保
appsettings.json包含有效的SIOMS API设置 - 验证SIOMS API是否正在运行并可访问
- 检查用户名/密码凭据
❌ “无法使用SIOMS API进行身份验证”
- 验证中的凭据
appsettings.json - 检查是否可以从MCP服务器访问SIOMS API
- 确保用户具有所需的权限(大多数操作都是管理员/经理角色)
❌ “网络错误”或超时问题
- 验证
SiomsApi:BaseUrl是正确的 - 检查到SIOMS API的网络连接
- 增加
SiomsApi:TimeoutSeconds如有需要
调试模式
通过将日志级别设置为启用详细日志记录 Debug 在……里面 appsettings.json:```json
{
"Logging": {
"LogLevel": {
"Default": "Debug",
"sioms_mcp": "Debug"
}
}
}
## 使用示例
### 检查仓库库存```
Please check the inventory for warehouse 1 with detailed product information
管理库存水平```
Add 100 units of product 5 to warehouse 2
### 产品分析```
Show me detailed information for product 10 including stock distribution
低库存监控```
Check for low stock items in warehouse 3 and provide reorder recommendations
```
依赖项
- 微软。扩展。托管 (9.0.8)-应用程序托管
- 模型上下文协议 (0.3.0-preview.4)-MCP服务器框架
- 微软。扩展。Http (9.0.8)-HTTP客户端工厂
- 牛顿软。我是 (13.0.3)-JSON序列化
- 系统。身份模型。代币。智威汤逊 (8.2.1)-JWT令牌处理
许可证
该项目是SIOMS生态系统的一部分。请参阅您的SIOMS许可协议。
支持
有关SIOMS MCP服务器的支持:
- 检查上面的故障排除部分
- 查看SIOMS API文档
- 验证SIOMS API是否正确运行
- 检查应用程序日志以获取详细的错误信息
🚀 准备好使用人工智能工具增强您的库存管理!
