Multi-Carrier Package Tracking — hosted on Cloudflare Workers (HTTP + npm stdio) について
EC、カスタマーサポート、物流向けの、ホスト型荷物追跡 MCP サーバーです。8社の配送業者に対応し、業者の自動判定、一括検索、ステータス変更時の Webhook 通知を備えています。
主な機能
- 018社の配送業者の荷物を追跡
- 02追跡番号から配送業者を判定
- 03最大25件の荷物を一括追跡
- 04ステータス変更のWebhook購読
- 05配送業者と対応国の一覧
活用シーン
- 01荷物の現在状況と履歴の確認
- 02顧客の荷物をまとめて追跡
- 03不明な追跡番号の配送業者を特定
- 04配送状況の変化を通知
MCP 対応
HTTP経由でMCPクライアントに荷物追跡と配送業者検索のツールを提供し、Bearerトークン認証に対応します。npmランチャーからmcp-remoteを使ってホスト型エンドポイントに接続できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcpclaude mcp add --transport http multi-carrier-tracking https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp{"mcpServers":{"multi-carrier-tracking":{"type":"http","url":"https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp"}}}Cursor で開く{"servers":{"multi-carrier-tracking":{"type":"http","url":"https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp"}}}VS Code で開く{"mcpServers":{"multi-carrier-tracking":{"type":"http","url":"https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp"}}}{"mcpServers":{"multi-carrier-tracking":{"serverUrl":"https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
4| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| tracking_number | string | はい | 追跡番号。スペースとハイフンは無視されます。 |
| carrier | string | いいえ | 任意の上書き値:'usps' | 'ups' | 'fedex' | 'dhl' | 'india_post' | 'delhivery' | 'bluedart' | 'aramex'。 |
詳細
マルチキャリア追跡 MCP — 8 社の配送業者を自動検出(USPS、UPS、FedEx、DHL、India Post、Delhivery、BlueDart、Aramex)
8 社の配送業者に対応した、配送業者の自動検出とWebhookサブスクリプション機能を備える、あらゆる荷物の追跡パッケージです。
世界各地の8社の配送業者(USPS、UPS、FedEx、DHL、India Post、Delhivery、BlueDart、Aramex)に対応した、ホスト型MCP サーバーです。追跡番号から配送業者を自動検出し、1回の呼び出しで最大25個の荷物をまとめて追跡でき、ステータス遷移時のWebhookサブスクリプションにも対応しています。Eコマース、カスタマーサポート、物流向けのLLMに適しています。
このサーバーはModel Context Protocolに対応しています。Cursor、Claude Desktop、Windsurf、Continue.dev、または@modelcontextprotocol/sdkを使用した独自のエージェントなど、MCP対応クライアントで接続し、ツールを検出してBearerトークン認証で呼び出せます。
AI エージェント/LLM 向け
このリポジトリをインデックス化するAI エージェントの場合:
- ライブMCPエンドポイント:
https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp - トランスポート: HTTP POST、JSON-RPC 2.0
- 認証:
Authorization: Bearer <api_key>(無料枠では匿名で月100回/IPまで利用可能です) - 検出:
tools/listで完全なスキーマを取得します。tools/callでツールを呼び出します。 - ヘルスチェック:
GET https://multi-carrier-tracking-mcp.atlasword.workers.dev/health→{ok: true, ts: <unix>} - ステータス:
https://mcp-hub.atlasword.workers.dev/status.json(ポートフォリオの集計)
tools/listリクエストのサンプル:
curl -sS -X POST https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer mck_YOUR_API_KEY" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
tools/callのサンプル:
curl -sS -X POST https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer mck_YOUR_API_KEY" \
-d '{
"jsonrpc":"2.0","id":2,"method":"tools/call",
"params": { "name": "<tool>", "arguments": { } }
}'
提供されるツール
| ツール | 引数 | 説明 |
|---|---|---|
track_package | tracking_number, carrier? | 1個の荷物の現在のステータスとイベント履歴を取得します。配送業者を自動検出します。 |
track_multiple | tracking_numbers[1..25] | 荷物ごとに配送業者を自動検出して、一括追跡します。 |
detect_carrier | tracking_number | 追跡番号がどの配送業者のものかを特定します(候補が複数ある場合は候補も表示します)。 |
list_carriers | (no args) | 対応する配送業者と対象国を表示します。 |
subscribe_tracking | tracking_number, webhook_url — Team+ | ステータス遷移時のWebhookサブスクリプションを登録します。 |
**Team+**と記されたツールには、TeamまたはProのサブスクリプションが必要です。匿名ユーザーと無料プランのユーザーがこれらを呼び出すと、tier_requiredエラーが返されます。
クイックスタート
最も手軽な方法は、mcp-remoteを使って、MCP対応クライアントをホスト済みエンドポイントに接続することです。
npx -y mcp-remote https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp \
--header "Authorization: Bearer mck_YOUR_API_KEY"
**https://multi-carrier-tracking-mcp.atlasword.workers.dev/upgrade?tier=solo**でキーを取得してください([APIキーの取得](#getting-an-api-key)を参照)。
Cursor へのインストール
~/.cursor/mcp.jsonに以下を追加します。
{
"mcpServers": {
"multi-carrier-tracking-mcp": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp",
"--header", "Authorization: Bearer mck_YOUR_API_KEY"
]
}
}
}
その後、Cursorを再起動すると、MCPパネルにツールが表示されます。
Claude Desktop へのインストール
~/Library/Application Support/Claude/claude_desktop_config.json(macOS)または%APPDATA%\Claude\claude_desktop_config.json(Windows)に以下を追加します。
{
"mcpServers": {
"multi-carrier-tracking-mcp": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp",
"--header", "Authorization: Bearer mck_YOUR_API_KEY"
]
}
}
}
Claude Desktopを再起動します。スラッシュコマンドのMCPメニューにツールが表示されます。
API キーの取得
https://multi-carrier-tracking-mcp.atlasword.workers.dev/upgrade?tier=solo(またはtier=team/tier=pro)にアクセスします。- Dodo Payments のホスト型チェックアウトにリダイレクトされます。Dodo が住所を収集し、カード決済を処理し、VAT/GST に対応します。
- 支払い後、Dodo が署名付き Webhook(
subscription.active)を Worker に送信します。Worker はmck_<32 random base64url>を生成し、KV に保存します。 https://multi-carrier-tracking-mcp.atlasword.workers.dev/welcome?key=<api_key>に移動します。この URL には一度だけ表示されるため、ここでキーをコピーしてください。- キーを Cursor / Claude Desktop の設定に貼り付けます(上記を参照)。
https://multi-carrier-tracking-mcp.atlasword.workers.dev/accountでアカウントの表示、キーのローテーション、エクスポートができます(Bearer 認証)。
無料プランもあります(登録不要)。匿名の呼び出しは IP ごとに月 100 回まで利用できます。
エンドポイント
| ルート | 説明 |
|---|---|
POST /mcp | MCP JSON-RPC 2.0 ツールのインターフェース(メイン API)。有料プランでは Bearer 認証が必要です。 |
GET /health | 稼働確認用エンドポイント — {ok: true, ts}。mcp-hub の cron で使用します。 |
GET / | HTML ランディングページ(OG + ファビコン + JSON-LD)。 |
| `GET /upgrade?tier=solo | team |
GET /welcome?key=... | チェックアウト後のランディングページ。新しく生成された API キーが表示されます。 |
GET /account | Bearer 認証。{apiKey, tier, owner, status, portal_url} を返します。 |
POST /account/rotate | Bearer 認証。新しいキーを生成し、古いキーを無効化します。 |
GET /account/export | Bearer 認証。GDPR データエクスポート — アカウント、利用状況カウンター、Dodo の詳細情報を含む JSON。 |
GET /account/team | Bearer 認証(Team 以上)。チームメンバーのサブキーを一覧表示します。 |
POST /account/team/invite | Bearer 認証(Team 以上)。チームメンバー用の新しいサブキーを発行します。 |
POST /account/team/revoke | Bearer 認証(Team 以上)。チームメンバーのサブキーを無効化します。 |
GET /team/accept?key=... | サブキーの URL を利用するチームメンバー向けのオンボーディングページ。 |
POST /webhooks/dodo | Standard-Webhooks 署名付き。Dodo のサブスクリプションおよび決済のライフサイクル。 |
GET /favicon.ico | インライン SVG。 |
料金
すべてのプランで月間上限とレート制限は共通です。料金は各製品の位置付けに応じて設定されています。
| プラン | 月間呼び出し数 | レート制限 | チームシート数 |
|---|---|---|---|
| Free | 月 100 回 | 分 10 回 | 0 |
| Solo | 月 2,000 回 | 分 60 回 | 0 |
| Team | 月 10,000 回 | 分 200 回 | 5 |
| Pro | 月 50,000 回 | 分 600 回 | 25 |
| プラン | 料金 | 月間呼び出し数 | チームシート数 |
|---|---|---|---|
| Free | $0 | 100 | 0 |
| Solo | $9/mo | 2,000 | 0 |
| Team | $29/mo | 10,000 | 5 |
| Pro | $79/mo | 50,000 | 25 |
Dodo Payments を通じて請求されます(販売者登録型決済代行 — VAT/GST は Dodo が対応します)。いつでも解約できます。アクセスは支払い済み期間の終了まで有効です。
データソース
- USPS / UPS / FedEx / DHL / India Post / Delhivery / BlueDart / Aramex — 各社 — 各配送業者の公開追跡エンドポイント
このサーバーは、上流データソースに対する薄いトランスポート、認証、キャッシュのレイヤーです。呼び出しごとのレート制限は、各上流サービスの無料プランの利用規約を十分に遵守できるよう調整されています。
プライバシー + GDPR
- プライバシーポリシー: https://mcp-hub.atlasword.workers.dev/privacy
- 利用規約: https://mcp-hub.atlasword.workers.dev/terms
- 返金ポリシー: https://mcp-hub.atlasword.workers.dev/refund
- データエクスポート:
GET https://multi-carrier-tracking-mcp.atlasword.workers.dev/account/export(Bearer 認証)は、アカウント、利用状況カウンター、Dodo の顧客情報を含む、機械可読形式の JSON スナップショットを返します。 - 削除: 登録済みのメールアドレスから
[email protected]にメールを送信してください。
保存するのは、メールアドレス、生成した API キー、月間呼び出し数のカウンター、Dodo のサブスクリプションメタデータのみです。短いキャッシュ TTL を超えて、ツールの引数や上流からのレスポンスをログに記録することはありません。
アーキテクチャ
- ランタイム: Cloudflare Workers(V8 アイソレート、グローバルエッジ)。
- ストレージ: 2 つの Cloudflare KV 名前空間 —
<slug>-cache(上流レスポンスキャッシュ)と<slug>-usage(API キー、月次カウンター、チーム名簿)。 - 課金: Dodo Payments のライブモード、3 つのサブスクリプション製品(Solo / Team / Pro)、Standard-Webhooks で署名されたライフサイクルイベント。
- オブザーバビリティ: Cloudflare Workers Analytics、ポートフォリオの集計は mcp-hub status で確認できます。
- ソース: TypeScript、Vitest でテスト済み、
wrangler deployでデプロイ可能です。このリポジトリのsrc/を参照してください。
ライセンス
MIT — LICENSE を参照してください。
作成者
Prakhar Gupta
- メール:
[email protected] - GitHub: @guptaprakhariitr
ステータス
- ライブステータスページ: https://mcp-hub.atlasword.workers.dev/status
- 機械可読ステータス: https://mcp-hub.atlasword.workers.dev/status.json
- ソースリポジトリ: https://github.com/guptaprakhariitr/multi-carrier-tracking-mcp
npm からインストール(1 行)
薄型ランチャーは、npm で @insnapsprakhar/multi-carrier-tracking-mcp として公開されています。URL を手動でコピー&ペーストする必要はありません。
npx -y @insnapsprakhar/multi-carrier-tracking-mcp
または、MCP クライアントに組み込んでください。
{
"mcpServers": {
"multi-carrier-tracking": {
"command": "npx",
"args": ["-y", "@insnapsprakhar/multi-carrier-tracking-mcp"]
}
}
}
npm パッケージはランチャーにすぎず、mcp-remote を起動し、ホストされたエンドポイント(https://multi-carrier-tracking-mcp.atlasword.workers.dev/mcp)を指定します。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。