higress/plugins/wasm-go/mcp-servers/mcp-logistics-tracking-query/README_ZH.md

物流轨迹查询

API认证需要的APP Code请在阿里云API市场申请: https://market.aliyun.com/apimarket/detail/cmapi00048162

什么是云市场API MCP服务

阿里云云市场是生态伙伴的交易服务平台，我们致力于为合作伙伴提供覆盖上云、商业化和售卖的全链路服务，帮助客户高效获取、部署和管理优质生态产品。云市场的API服务涵盖以下几个类目：应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI应用与OCR、生活服务。 云市场API依托Higress提供MCP服务，您只需在云市场完成订阅并获取AppCode，通过Higress MCP Server进行配置，即可无缝集成云市场API服务。

如何在使用云市场API MCP服务

1. 进入API详情页，订阅该API。您可以优先使用免费试用。
2. 前往云市场用户控制台，使用阿里云账号登陆后查看已订阅API服务的AppCode，并配置到Higress MCP Server的配置中。注意：在阿里云市场订阅API服务后，您将获得AppCode。对于您订阅的所有API服务，此AppCode是相同的，您只需使用这一个AppCode即可访问所有已订阅的API服务。
3. 云市场用户控制台会实时展示已订阅的预付费API服务的可用额度，如您免费试用额度已用完，您可以选择重新订阅。

MCP服务器功能简介文档

功能简介

logistics-tracking-query 服务器主要用于处理与快递相关的查询请求，包括但不限于自动识别快递单号所属的快递公司以及获取指定快递包裹的运输路径详情。此服务对于需要整合多种不同快递服务商信息的应用程序非常有用，它简化了开发者对接多个独立API的过程，并提供了一个统一的数据访问接口。

工具简介

单号识别快递公司

• 用途：基于用户提供的快递单号智能匹配出对应的快递服务提供商。
• 应用场景：适用于电商平台、订单管理系统等需要快速确定顾客使用的快递公司的场合。
• 参数说明：
  • mailNo (必填)：用户输入的快递单号，用于查找相关联的快递公司信息。

物流轨迹查询

• 用途：根据快递单号及相关信息调用API获取最新的物流动态更新。
• 应用场景：适合所有希望向其用户提供实时包裹位置更新的服务，如购物网站、第三方物流监控应用等。
• 参数说明：
  • cpCode (必填)：快递公司的唯一标识码。
  • mailNo (必填)：待查询的快递单号。
  • phone (选填)：当涉及顺丰或丰网时需提供收件人/寄件人的手机号全号或者后四位数字以增强验证准确性。

这两个工具共同作用下，能够有效地为用户提供从识别快递公司到全程跟踪包裹状态的一站式解决方案，极大提升了用户体验的同时也减轻了开发者的集成负担。