内容
# 零件管理服务器
[](https://crates.io/crates/mcp-parts)
[](LICENSE)
[](https://enterprise.adk-rust.com)
[](https://www.zavora.ai)
用于 [ADK-Rust 企业版](https://enterprise.adk-rust.com) 汽车和制造代理的零件和备件平台。27 个 MCP 工具涵盖了零件目录、**多地点库存与补货点**、**物料清单和用途**、**替代链**、供应商、库存变动、预订、补货建议和**基于用量的需求预测** — 具备完整的库存变动审计追踪。
## 平台，而非点解决方案
该平台被设计为通用的零件/备件库存骨干（EAM/CMMS 或 DMS 零件模块的底层），因此一系列库存和维护代理都是一个共享系统的客户端：
| 代理 | 领域 | 用途 |
|-------|--------|------|
| **库存优化器** | 汽车 | `补货建议`、`零件库存`、`展开物料清单`、`转移库存` |
| **预测性车队维护** | 汽车 | `需求预测`、`解析替代链`、`预订库存`、`发放库存` |
| **预测性维护代理** | 制造 | `需求预测`、`用途查询`、`记录用量`、`补货建议` |
## 架构
<p align="center">
<img src="https://raw.githubusercontent.com/zavora-ai/mcp-parts/main/docs/architecture.svg" alt="零件 MCP 架构" width="780"/>
</p>
## 功能
- **目录** — 零件包含零件编号、类别、单位、成本、首选供应商和交货期；生命周期状态（活跃/已替代/已淘汰）。
- **多地点库存** — 每个零件在每个地点的库存，包括现有库存、预订库存和补货策略（补货点 + 数量）。`零件库存`汇总了跨地点的可用库存。
- **库存变动** — `接收库存`、`发放库存`、`转移库存`、`调整库存`，每次变动都不可篡改。发放/转移/预订不会超售可用库存；调整不会导致现有库存为负。
- **预订** — 在工单/资产上预订可用库存，而不减少现有库存；取消预订以释放。
- **物料清单和用途** — 物料清单具备**递归展开**（数量乘积）和循环预防；反向查询`用途`。
- **替代链** — 旧 → 新的替代链；`解析替代链`沿着链找到当前的活跃零件。
- **补货和预测** — `补货建议`标记库存达到或低于其补货点；`需求预测`根据历史数据得出平均日用量，预测需求，推荐补货点（交货期需求 + 安全库存），并报告库存风险与交货期。
## 管理姿态
- **两次写入会消耗物理库存，并且是受控的**（`需要审批`、`外部写入`）：`发放库存`（消耗/安装的零件 — 同时记录用量）和`调整库存`（覆盖已记录的库存）。接收和转移是正常的内部写入。
- **变动完整性** — 每次变动和调整都有库存超售和负库存防护；每次变动和调整都记录在审计追踪中（`审计日志`）。
- **只读`读取`。示例数据是虚构的。
## 工具（27）
### 目录、地点和供应商（7）
`创建零件` · `获取零件` · `列出零件` · `创建地点` · `列出地点` · `创建供应商` · `列出供应商`
### 库存和变动（8）
`设置库存策略` · `获取库存` · `零件库存` · `接收库存` · `发放库存`（受控，外部） · `转移库存` · `调整库存`（受控，外部） · `零件变动`
### 预订（3）
`预订库存` · `取消预订` · `列出预订`
### 物料清单和替代链（5）
`添加物料清单行` · `展开物料清单` · `用途查询` · `添加替代链` · `解析替代链`
### 补货、预测和审计（4）
`补货建议` · `记录用量` · `需求预测` · `审计日志`
## 示例
```jsonc
// 库存优化器：需要订购的内容，以及构建消耗的内容
{"name": "补货建议", "arguments": {}}
{"name": "展开物料清单", "arguments": {"parent_id": "PRT-1004", "multiplier": 5}}
// 预测性维护：预测消耗品的需求
{"name": "需求预测", "arguments": {"part_id": "PRT-1007", "horizon_days": 30}}
// 车队维护：解析已替代的零件，然后发放（受控）
{"name": "解析替代链", "arguments": {"part_id": "PRT-1009"}}
{"name": "发放库存", "arguments": {"part_id": "PRT-1002", "location_id": "LOC-1003", "qty": 4, "reason": "wo-1"}}
```
## 安装和运行
```bash
cargo install mcp-parts
mcp-parts # 通过 stdio 提供 MCP 服务
```
或从源代码构建：
```bash
git clone https://github.com/zavora-ai/mcp-parts
cd mcp-parts && cargo build --release
./target/release/mcp-parts
```
## 注册表清单
```toml
server_id = "mcp_parts"
display_name = "零件和备件"
version = "1.0.0"
domain = "automotive"
risk_level = "high"
writes_allowed = "gated"
```
完整的 [`mcp-server.toml`](mcp-server.toml) 声明了所有 27 个工具的风险类别和注册表上线审批门控。
## 许可证
Apache-2.0
