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 分