SIOMS MCP服务器
智能库存和订单管理系统（SIOMS）的模型上下文协议（MCP）服务器，为人工智能助手提供全面的库存管理工具。
概述
此MCP服务器使人工智能助手能够与SIOMS API交互，以执行高级库存管理操作。它提供了15多种强大的工具，用于检查库存水平、管理库存、分析仓库绩效和维护产品目录。
特性
🏪 核心库存管理
- 实时库存检查 所有仓库
- 低库存警报 提供重新订购建议
- 全面的库存报告 通过分析
- 跨仓库库存可见性
📦 库存管理操作
- 添加库存 带验证的仓库
- 移除库存 进行安全检查
- 更新库存 精确数量
- 批量操作 支持
📋 产品管理
- 产品目录 使用过滤进行浏览
- 详细的产品分析 包括库存分配
- 新产品创建 通过验证
- 价格分类 和分析
🏬 仓库分析
- 仓库性能 指标
- 健康评分 系统（0-100刻度）
- 分布分析 跨地点
- 可采取行动的建议
安装和设置
1.先决条件
- .NET 9.0 SDK
- 正在运行SIOMS API实例
- 有效的SIOMS用户凭据
2.配置服务器
编辑 appsettings.json 与您的SIOMS API详细信息：
{
"SiomsApi": {
"BaseUrl": "http://localhost:5000",
"Username": "your_username",
"Password": "your_password",
"TokenRefreshMinutes": 50,
"TimeoutSeconds": 30
}
}3.构建和运行
# 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）：包括详细的产品信息
示例响应：
{
"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（字符串）：唯一SKUprice（十进制）：产品价格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:
{
"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是否正确运行
- 检查应用程序日志以获取详细的错误信息
______________________________________________________________________
🚀 准备好使用人工智能工具增强您的库存管理！