产品与计划——产品目录和保修计划,包含覆盖条款:期限、覆盖故障类型、排除项、每次理赔免赔额、总覆盖上限及可转让性。
它为代理提供什么
一个专门为单个 MCP 连接设计的能力。
服务器拥有其领域逻辑,并发布 MCP 客户端可发现的工具契约。ADK-Rust 可将该契约加载到代理中,为所选模型提供者规范每个模式,并将连接生命周期保持在代理业务逻辑之外。
注册——将计划绑定到序列号和所有者;覆盖期根据计划期限和购买日期计算(月精度,日限制)。转让遵循计划的转让规则。
权益——check_entitlement 报告覆盖期状态、剩余天数、故障类型是否覆盖或排除、免赔额和剩余额度。
理赔生命周期——提交 → 分诊 → 批准/拒绝 → 维修中 → 关闭。validate_claim 是只读的裁定预检查;approve_claim 重新验证覆盖并拒绝不符者。
RMA / 维修——仅对批准的理赔发出 RMA(维修/更换/退款);状态流:已发出 → 已接收 → 已维修 → 已发货 → 已关闭;关闭 RMA 同时关闭理赔。
分析——按状态统计理赔,批准率,总计及平均批准赔付,支持按产品范围筛选。
架构
Warranty MCP Server 在代理系统中的作用。
模型无需了解服务器背后系统的实现细节或凭证。它看到审核过的工具定义。MCP 客户端负责发现和调用,服务器保持验证、策略和与领域系统的通信所有权。
ADK-Rust 代理
从审核过的工具目录中选择能力。
MCP 客户端
发现模式,发送调用,并接收类型化内容。
Warranty MCP Server
验证请求并拥有 24 个已记录工具契约。
领域系统
维护服务器背后的 API、数据、凭证和业务规则。
来自项目文档
服务器发布的架构
工具目录
代理可以请求 Warranty MCP Server 做什么?
每个工具都有稳定名称、易读的用途和 MCP 初始化时发现的 JSON 输入契约。风险类别来自项目的注册清单(如果有)。
24 个命名工具
create_product创建产品目录条目
internal writeget_product通过 ID 获取产品
read onlylist_products按类别列出产品
read onlycreate_plan创建带覆盖条款的保修计划
internal writeget_plan获取保修计划
read onlylist_plans列出保修计划
read onlyregister注册设备并绑定计划(计算覆盖期)
internal writeget_registration通过 ID 或序列号获取注册信息
read onlylist_registrations按所有者/状态列出注册
read onlytransfer_registration转让注册(若计划支持转让)
internal writecheck_entitlement检查注册的覆盖/权益
read onlysubmit_claim提交保修理赔
internal write治理
了解每个工具的作用。
服务器连接继承其凭证和部署环境的权限。以下声明来自本项目的 README 和 MCP 注册清单;您的应用程序仍决定代理接收哪些工具以及何处需要批准。
- 三个写操作涉及财务/合同责任,受限(需要审批,external_write):approve_claim(提交赔付)、reject_claim(合同拒绝)、issue_rma(发出 RMA)。
- 覆盖不可绕过——批准时重新验证覆盖期、覆盖故障列表、排除项和额度;过期注册或排除故障会被拒绝(测试中验证)。
- validate_claim 为只读,允许代理预先检查裁定,无副作用。所有重要操作均有审计日志(audit_log)。
- 示例数据为虚构。
MCP 接口
当前文档声明的内容。
MCP 可传输工具、资源、提示、结构化结果、进度、取消和长时间运行的工作。此记录突出显示本仓库明确提及的现代协议特性。
安装并连接
遵循项目文档中的起点。
在拥有凭证和领域访问权限的环境中安装服务器。将其添加到您的 MCP 主机,验证发现的工具,并在交付生产代理前缩小工具集。
cargo install mcp-warrantylet toolset = McpToolset::from_stdio(
"mcp-warranty",
["mcp-warranty"],
).await?;
let agent = LlmAgentBuilder::new("agent")
.tools(toolset.tools().await?)
.build()?;命令和配置从公开的 README 中提取。部署前请确认官方文档中的先决条件、环境变量和特定版本选项。
官方文档
继续使用项目维护者的权威信息源。
此页面提供服务器的易懂地图。仓库对确切的模式、先决条件、配置、示例、测试、版本和安全更新保持权威。
继续探索