mcp-yandex-dostavka 是 A1-x-Tech 开发的 MCP 服务器，用于对接 Яндекс Доставка（Yandex Delivery）的 B2B API。它让用户可在 Claude、Codex、Cursor、VS Code 等 AI 应用中用日常语言下达配送任务，由助手访问用户的 Yandex Delivery 账户，计算运费、办理寄件并显示状态，无需自行开发集成。
主要用途与能力
- 当日达（市内）：计算运费、距离与预计上门时间；办理寄件，提交商品、地址、联系人和对车辆或快递员的要求；按状态、电话、时间段或公司订单号查找订单；获取快递员当前位置与收件人追踪链接；在了解后果的前提下取消（先查询是否可取消及是否收费）。
- 次日达与俄罗斯境内：比较可用的送达时段与门到门运费；办理所选方案；查询订单当前状态与变更历史；在当前状态允许时提交取消请求。
- 自提点与快递柜：按城市、坐标、类型和支付方式查找自提点与快递柜；查看地址、营业时间、自助寄件可用性和支付方式；计算并办理送往所选地点的配送。
工作方式 服务器内置 16 项现成操作、数据模式以及应对重复请求的安全规则。助手先进行预计算（预估价、距离、ETA），用户明确要求后才把数据传给 Yandex Delivery，等待最终估价并开始寻找快递员；此后可查询状态、查看快递员位置、获取追踪链接。费用、ETA、可用时段、自提点地址和状态均来自用户的 Yandex Delivery 账户，不会自行编造。助手不会持续监控订单，只在被要求时检查状态；若 AI 应用支持定时任务，可在其界面配置定期检查。明确的下单或取消指令即授权相应操作，额外确认行为取决于所用 AI 应用。
使用方式 需要 Node.js 20+ 和企业客户端令牌。先在 dostavka.yandex.ru 注册为企业客户并签订合同（次日达、俄罗斯境内、自提点和快递柜还需接入发货站点）；在个人中心「Интеграции」标签点击「获取令牌」，将令牌通过环境变量 YANDEX_DELIVERY_TOKEN 传给服务器。 集成方式（按官方说明）：
- 应用界面：Settings → MCP servers → Add server → 选择 STDIO，命令为 npx -y mcp-yandex-dostavka@latest，并设置环境变量 YANDEX_DELIVERY_TOKEN；保存后重启。
- Codex：通过命令行保存到通用配置，已打开则重启。
- Claude Desktop：官方路径为 Settings → Extensions；本仓库目前发布 stdio 的 npm 包，尚无 .mcpb，可在仍支持本地配置的版本中使用 JSON stdio 配置（macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%\Claude\claude_desktop_config.json），保存后重启。
- Claude Code：在终端执行相应命令。
- Cursor：在 ~/.cursor/mcp.json（Windows 为 %USERPROFILE%.cursor\mcp.json）中添加 yandex-dostavka 条目，保存后重启。
- VS Code：命令面板执行 MCP: Open User Configuration，在用户级 mcp.json 中添加服务器；首次启动会提示输入令牌并保存为隐藏值；可用 MCP: List Servers 检查。 连接后新建对话，即可用自然语言下达任务，例如「计算从 Льва Толстого, 16 到 Тверскую, 7 的 2 公斤箱子运费」。
技术设置与限制
- 令牌：通常一个通用 YANDEX_DELIVERY_TOKEN 即可；若不同配送类型在不同账户中开通，可分别设置 YANDEX_DELIVERY_EXPRESS_TOKEN（当日达）和 YANDEX_DELIVERY_PLATFORM_TOKEN（次日达/俄罗斯境内/自提点/快递柜）。若没有通用令牌，则需同时提供两个专用令牌。令牌长期有效，但个人中心改密后失效；它以明文保存在 AI 应用配置中，应视同密码，勿将含真实令牌的配置提交到 Git。
- 测试环境：仅次日达、俄罗斯境内、自提点和快递柜有测试环境，设置 YANDEX_DELIVERY_PLATFORM_BASE_URL=https://b2b.taxi.tst.yandex.net 并使用官方说明中的测试凭证，且仅处理莫斯科地址。当日达没有测试环境：可安全测试运费计算和读取已有申请，但创建的寄件会进入生产系统。
- 底层上，服务器对接 B2B API 的两个独立部分（当日达 API 与次日达 API），二者令牌、服务器地址、金额格式和计量单位可能不同，MCP 服务器会自动选择正确参数。
- 隐私：服务器在本地运行并直接访问 Yandex Delivery API，Bearer 令牌只添加到所选 API 的请求；通用工具的路径为相对路径，若指向外部服务器会被拦截，避免令牌外泄。默认向 usage.gistrec.cloud 发送匿名技术遥测（服务器启动、调用的工具名、未配置令牌时的启动原因码），含随机安装标识、包版本、AI 应用名称与版本、Node.js 版本和操作系统；不读取或发送令牌、账户数据、工具参数和请求文本，后台发送超时 2 秒，不影响运行；可在配置中添加禁用项关闭遥测，实现位于 src/telemetry.ts。
- 注意事项：它能办理和取消真实配送，取消可能收费；AI 应用决定是否在写入前额外确认；当日达无测试环境；无持续监控；遇到临时限制时服务器会自行等待并重试，若 Yandex Delivery 仍不可用需稍后再试；没有自动回滚，能否取消及费用取决于当前状态和 Yandex Delivery 规则。
