Delivery Tracking (Korea)

@appmonster/mcp-delivery

荷物の追跡用 MCP サーバーです。Delivery Tracker を通じて、韓国の配送業者（CJ대한통운、우체국、한진、롯데、로젠、경동、쿠팡、편의점택배…）や世界各地の配送業者（Yamato、Sagawa、Japan Post、DHL、UPS、FedEx、USPS、EMS）を利用できます。読み取り専用です。韓国の配送業者名をそのまま使用できます。

택배 조회 MCP 서버 — 「この注文は今どこ？」「今日発送された荷物のうち、まだ届いていないのは？」といった質問にエージェントが回答します。

ツール

ツール	機能
delivery_track_parcel	荷物1個 → ステータス（접수/집화/이동중/배송출발/배송완료/실패/수령대기/이상）、delivered、needsAttention、最新イベント、イベント履歴（KST）
delivery_track_many	最大20個の荷物 → 荷物ごとのステータスと件数（配達完了／輸送中／要確認）。エラーは荷物ごとに分離され、指定した ref がそのまま返されます
delivery_list_carriers	対応する配送業者（id + name）と組み込みの別名一覧

配送業者は名前（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
• 「昨日発送したスマートストアの注文をすべて、配送状況を確認して」→ naver_list_orders → delivery_track_many（ref = 注文番号）
• 「配送に問題があるものだけ選んで、お客様に送るメッセージの下書きを作って」→ delivery_track_many → needsAttention で絞り込み

注意事項

• 無料プランの認証情報は21日ごとに期限切れになります — コンソールに有効期限が表示されます。期限前に新しい認証情報のペアを作成してください（期限切れになると、夜間のカナリアテストで AUTH として検出されます）。有料プランでは認証情報の有効期限はありません。
• Delivery Tracker の応答は通常1秒未満です。このクライアントはエージェントが応答待ちのまま停止しないよう、15秒後に TIMEOUT エラーを返します。
• 新しく発行された送り状番号は、配送業者から情報が報告されるまで数時間かかる場合があります（ヒント付きの NOT_FOUND）。
• 時刻はKST（+09:00）に変換されます。

MIT © Appmonster