mcpField
D
Delivery Tracking (Korea)

Delivery Tracking (Korea)

本地服务
appmonster.co.kr地图与出行05 天前更新
代码仓库访问官网

关于 Delivery Tracking (Korea)

Delivery Tracking (Korea) 是只读 MCP 服务，可查询韩国及国际承运商的包裹。它支持单件和批量追踪，并返回状态历史及需关注标记。

主要功能

  1. 01查询单个包裹
  2. 02每次最多追踪 20 件包裹
  3. 03查看 KST 时区的事件历史
  4. 04识别需关注的包裹
  5. 05列出支持的承运商及别名

适用场景

  1. 01查询包裹最新状态
  2. 02批量查看多笔订单的配送进度
  3. 03筛选配送异常包裹
  4. 04查找支持的承运商名称

MCP 相关

该 MCP 服务向 MCP 客户端提供包裹追踪、批量追踪和承运商列表工具，并使用 Delivery Tracker 凭据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "groove79-mcp-delivery": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-delivery"
      ],
      "env": {
        "DELIVERY_TRACKER_CLIENT_ID": "<DELIVERY_TRACKER_CLIENT_ID>",
        "DELIVERY_TRACKER_CLIENT_SECRET": "<DELIVERY_TRACKER_CLIENT_SECRET>"
      }
    }
  }
}
启动命令npx -y @appmonster/mcp-delivery
需要配置的环境变量
DELIVERY_TRACKER_CLIENT_IDClient ID from console.tracker.delivery (free)
DELIVERY_TRACKER_CLIENT_SECRET密钥Client Secret from console.tracker.delivery

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@appmonster/mcp-delivery0.1.0

工具

3

收录的工具列表 · 更新于 6 天前

参数类型必填说明
carrierstring是承运商名称或 ID，例如 CJ대한통운、우체국、kr.hanjin
maxEventsinteger否
trackingNumberstring是운송장 번호 — hyphens/spaces are ignored

详细介绍

@appmonster/mcp-delivery

用于包裹追踪的 MCP 服务——通过 Delivery Tracker 查询韩国承运商（CJ대한통운、우체국、한진、롯데、로젠、경동、쿠팡、편의점택배……）和国际承运商（Yamato、Sagawa、Japan Post、DHL、UPS、FedEx、USPS、EMS）。只读。可直接使用韩语承运商名称。

包裹查询 MCP 服务——让 Agent 回答“这个订单到哪儿了？”“今天发出的包裹中，还有哪些没送到？”

工具

工具功能
delivery_track_parcel查询单个包裹 → 状态（접수/집화/이동중/배송출발/배송완료/실패/수령대기/이상）、delivered、needsAttention、最近事件、事件历史（KST）
delivery_track_many查询最多 20 个包裹 → 每个包裹的状态和统计（已送达 / 运输中 / 需要关注）；错误按包裹分别处理；回传你的 ref
delivery_list_carriers支持的承运商（id + 名称）及内置别名

承运商可以使用名称（CJ대한통운、우체국、한진、야마토、DHL）或 id（kr.cjlogistics）。未知名称会回退到实时搜索。

设置（1 分钟，免费）

  1. 前往 https://console.tracker.delivery → 登录（Google/邮箱）→ Create Project → Credentials → Create → 复制 Client ID / Client Secret（密钥只会显示一次）。
  2. Claude Desktop / Cursor：
{ "mcpServers": { "delivery": { "command": "npx", "args": ["-y", "@appmonster/mcp-delivery"],
  "env": { "DELIVERY_TRACKER_CLIENT_ID": "…", "DELIVERY_TRACKER_CLIENT_SECRET": "…" } } } }

提示词示例

  • “CJ 1234-5678-9012 现在到哪儿了？” → delivery_track_parcel
  • “确认昨天发出的所有 SmartStore 订单的配送状态” → naver_list_orders → delivery_track_many（ref = 订单号）
  • “挑出配送异常的包裹，并起草一条发给客户的短信” → delivery_track_many → 筛选 needsAttention

备注

  • 免费套餐的凭据每 21 天过期——控制台会显示到期时间；请在到期前创建一组新凭据（凭据过期时，我们的夜间 canary 会将其标记为 AUTH）。付费套餐提供永久有效的凭据。
  • Delivery Tracker 通常会在 < 1 s 内响应；此客户端会在 15 s 后放弃并返回 TIMEOUT 错误，而不是让 Agent 一直等待。
  • 新创建的运单标签可能需要几小时后承运商才会报告信息（会返回带有提示的 NOT_FOUND）。
  • 时间会转换为 KST（+09:00）。

MIT © Appmonster

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。