Delivery Tracking (Korea)

io.github.groove79由 GitHub 账号 groove79 发布v0.1.0更新于 Oct 30, 2026

Parcel tracking for Korean and global carriers (CJ, 우체국, 한진, 롯데, 로젠, 쿠팡, Yamato, DHL…). 택배 조회 MCP.

已验证STDIO仅桌面位置与生活商业与电商

概览

AI 生成的概览

本地 MCP 服务器，让助手通过 Delivery Tracker 查询韩国及全球快递的物流状态与事件记录。

可以做什么
  • 按快递公司名称或 id 查询单个运单，返回当前状态、最新事件和完整事件历史（KST 时间）
  • 一次查询最多 20 个运单，返回每个运单的状态、汇总计数，并回显自定义参考号
  • 列出支持的快递公司（id 与名称）及内置韩文/日文别名，可按文本筛选
适用场景
适合让助手回答“这个订单到哪了”、批量检查当天发出的包裹，或筛出需要关注的异常件，尤其适用于 CJ、邮局、韩进、乐天、Rosen、Coupang 等韩国快递。
运行要求
以 stdio 在本地运行，通常通过 npx 使用 npm 包。需要 Delivery Tracker 账号，以及来自 console.tracker.delivery 的环境变量 DELIVERY_TRACKER_CLIENT_ID 和 DELIVERY_TRACKER_CLIENT_SECRET，并需能访问 Delivery Tracker API 的网络。仅支持桌面客户端。
安装前请注意
需要客户端密钥 DELIVERY_TRACKER_CLIENT_SECRET，该密钥只显示一次，请勿写入共享配置。免费套餐凭据每 21 天过期，需要重新创建。查询数据会发送给第三方服务 Delivery Tracker。服务器自称只读，但你提供的运单号和参考号会与该服务共享。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Delivery Tracking (Korea)，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@appmonster/mcp-delivery

MCP server for parcel tracking — Korean carriers (CJ대한통운, 우체국, 한진, 롯데, 로젠, 경동, 쿠팡, 편의점택배…) and global ones (Yamato, Sagawa, Japan Post, DHL, UPS, FedEx, USPS, EMS) through Delivery Tracker. Read-only. Korean carrier names work directly.

택배 조회 MCP 서버 — "이 주문 어디쯤이야?", "오늘 발송분 중 아직 안 간 거?"를 에이전트가 답합니다.

Tools

ToolWhat it does
delivery_track_parcelone parcel → status (접수/집화/이동중/배송출발/배송완료/실패/수령대기/이상), delivered, needsAttention, last event, event history (KST)
delivery_track_manyup to 20 parcels → per-parcel status + counts (delivered / in transit / needs attention); errors isolated per parcel; your ref echoed back
delivery_list_carrierssupported carriers (id + name) with the built-in aliases

Carrier can be a name (CJ대한통운, 우체국, 한진, 야마토, DHL) or an id (kr.cjlogistics). Unknown names fall back to a live search.

Setup (1 minute, free)

  1. https://console.tracker.delivery → sign in (Google/email) → Create Project → Credentials → Create → copy Client ID / Client Secret (the secret is shown once).
  2. Claude Desktop / Cursor:
json
{ "mcpServers": { "delivery": { "command": "npx", "args": ["-y", "@appmonster/mcp-delivery"],  "env": { "DELIVERY_TRACKER_CLIENT_ID": "…", "DELIVERY_TRACKER_CLIENT_SECRET": "…" } } } }

Example prompts

  • "CJ 1234-5678-9012 지금 어디야?" → delivery_track_parcel
  • "어제 발송한 스마트스토어 주문 전부 배송 상태 확인해줘" → naver_list_orders → delivery_track_many (ref = 주문번호)
  • "배송 이상 있는 건만 골라서 고객한테 보낼 문자 초안 써줘" → delivery_track_many → filter needsAttention

Notes

  • Free plan credentials expire every 21 days — the console shows the expiration; create a new pair before then (our nightly canary flags it as AUTH when it lapses). Paid plans get lifetime credentials.
  • Delivery Tracker answers in < 1 s typically; this client gives up after 15 s with a TIMEOUT error instead of hanging the agent.
  • Brand-new labels can take a few hours before the carrier reports anything (NOT_FOUND with a hint).
  • Times are converted to KST (+09:00).

MIT © Appmonster

来源：packages/delivery/README.md，提交 f703332

工具

3

delivery_track_parcel

Track one parcel: current status (접수/집화/이동중/배송출발/배송완료/배송실패/수령대기/이상), last event, full event history with KST times. Carrier can be a Korean or English name (CJ대한통운, 우체국, 한진, 롯데, 로젠, 쿠팡, 야마토, DHL…) or a Delivery Tracker id like kr.cjlogistics. 운송장 1건을 조회합니다. Use for '이 주문 어디쯤이야?' or to confirm delivery before a settlement/CS reply. Needs carrier + trackingNumber; DELIVERY_TRACKER_CLIENT_ID/SECRET env.

输入参数carrier必填maxEventstrackingNumber必填

delivery_track_many

Track up to 20 parcels in one call and get a compact table: status per parcel plus counts of delivered / in transit / needs attention. Each item may carry your own reference (orderId) that is echoed back. 여러 운송장을 한 번에 조회합니다. Use after naver_list_orders / coupang_list_orders to answer '오늘 발송분 어디쯤?' or to find stuck parcels. Needs parcels[] of {carrier, trackingNumber, ref?}.

输入参数parcels必填

delivery_list_carriers

List carriers Delivery Tracker supports (id + name), optionally filtered by text, plus the built-in Korean/Japanese aliases this server understands. 지원 택배사 목록을 조회합니다. Use when a carrier name is ambiguous or to get the id for delivery_track_parcel. Needs nothing; optional searchText.

输入参数firstsearchTextcountryCode

版本历史

1
  1. v0.1.0最新Oct 22, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分