Yango Delivery MCP（A1 Yango Delivery MCP）是一个 MCP 服务器，用于将 AI 应用连接到企业版 Yango Delivery 账户。用户可以用自然语言估算快递价格、预约快递员、追踪路线并向收件人分享追踪链接。该服务器仅适用于国际 Express Claims API，不支持次日达、自提点或包裹柜。
主要能力
- 共 13 个工具：7 个覆盖配送生命周期，5 个用于追踪与快递员联系，另有 1 个直接 API 请求工具 raw_request。
- 下单前估算：在不创建配送申报的情况下检查当前价格、路线距离和预计到达时间（ETA）。
- 创建与下单分离：可以准备并审核申报，再开始搜索快递员。
- 追踪活跃配送：获取状态、快递员位置、各路线点 ETA、临时电话号码、确认码以及收件人追踪链接。
- 检查与取消配送：判断取消是免费、收费还是不再可用，并使用当前版本和 API 返回的取消模式取消申报。
- raw_request 覆盖没有专用工具的方法，包括费率、配送方式、派送证明、申报编辑和退货操作；可用于创建或更改真实数据，面向了解上游 API 的技术用户。
使用方式 需满足 Node.js 20+、Yango Delivery 企业账户和集成令牌。获取集成令牌后，将服务器添加到 AI 应用。常见启动命令为 npx -y mcp-yango-delivery@latest，环境变量为 YANGO_DELIVERY_TOKEN，采用 STDIO 方式。仓库提供了在多种 AI 客户端中的配置说明。可先通过示例提问开始，例如：估算一个 2 公斤包裹从 [取货地址] 到 [送货地址] 的配送。
配送流程
- 估算：价格检查返回当前报价、距离和 ETA，不创建任何内容。
- 创建：申报添加到账户并进入估算流程；默认尚未下单快递员。
- 审核：读取最新申报状态、价格和版本；成功申报进入可批准状态。
- 接受：接受后开始搜索快递员；自此配送已下单，可能产生实际费用。
- 追踪：快递员分配后，服务器可返回位置、ETA、联系方式和收件人链接。
限制与注意事项
- 定价报价通常约在估算后十分钟过期。若创建申报时传入 auto_accept: true，则跳过单独的审核和接受步骤，可能自动下单快递员。
- 服务器为读取、写入和破坏性操作提供 MCP 注解；AI 客户端决定何时以及如何请求确认。
- 申报创建使用唯一 request_id，重复使用同一 ID 会返回同一申报。接受和取消在网络错误或 5xx 响应后不会自动重试，因为操作可能已成功；重试前应读取当前申报。
- 集成令牌以明文存储在 AI 客户端的本地配置中，应视为密码，切勿提交包含真实令牌的配置。
- 服务器在用户机器上运行，将申报数据直接发送到 b2b.taxi.yandex.net；集成令牌仅附加到发往已配置 API 主机的请求。raw_request 接受相对路径并阻止解析到其他主机的请求。
- 默认会向 usage.gistrec.cloud 发送匿名技术遥测，包括服务器启动、调用的工具名和启动失败时的固定原因码；事件包含随机安装 ID、包版本、AI 客户端名称和版本、Node.js 版本和操作系统。不读取或发送集成令牌、申报数据、工具参数和提示。遥测超时两秒，不阻塞工具调用。可通过配置禁用。
- 无文档化的沙箱环境，应将申报创建和接受视为生产操作。报价有时间限制，接受前应读取当前申报。
- 追踪需要活跃申报；快递员分配前或申报完成后，位置、ETA、联系方式和追踪链接可能不可用。
- 未公布数值 API 配额。当 API 返回 429 时，服务器遵循 Retry-After（如有），并按 YANGO_DELIVERY_MAX_RETRIES 重试。
- 无后台监控：服务器仅在 AI 应用调用时工作。若应用支持计划任务，可定期检查活跃申报。
- 无自动回滚：在不确定的接受或取消结果后，应先读取申报再重复操作。
技术信息 项目提供完整 schema、响应字段和状态详情（见工具参考）。集成令牌与企业账户绑定，本身不过期，但更改账户密码会重置它。
