mcpField
U
USPS Holiday Shipping Deadlines MCP

USPS Holiday Shipping Deadlines MCP

リモート
github.com/theluckystrike地図・旅行01 日前に更新
リポジトリ

USPS Holiday Shipping Deadlines MCP について

国内、国際、軍事宛ての季節郵便を計画するためのUSPS向けMCPサーバーです。USPSのページが利用できる場合は推奨発送日を取得し、残り日数や各サービスが間に合うかを示します。

主な機能

  1. 01宛先別のホリデー発送期限
  2. 02発送推奨日までの残り日数
  3. 03発送日とサービスの期限内判定
  4. 04APO/FPO/DPO郵便番号の期限検索
  5. 05USPSのライブデータと内蔵の代替データ

活用シーン

  1. 01クリスマス配送に間に合うか確認
  2. 02季節郵便に使う郵便種別の選択
  3. 03軍事宛て郵便番号の発送期限確認
  4. 04国際ホリデー郵便の計画

MCP 対応

USPSのホリデー発送期限を調べるツールをMCPクライアントに提供します。呼び出し時にUSPSの期限ページを読み込み、利用できない場合は内蔵の2026年データ表を使います。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

usps-holiday-shipping-deadlines-mcp

AI アシスタント向けのUSPSのホリデーシーズン発送締切日です。「クリスマスに間に合うように発送するには、もう遅すぎますか?」と尋ねると、各郵便サービスのUSPS推奨発送日、今日からの日数、12月25日までに届くサービスを確認できます。

これはModel Context Protocol(MCP)サーバーです。呼び出し時にUSPSのホリデーシーズン発送日ページを読み取ります。APIキーは不要です。usps.comを読み取れない場合は、組み込みの2026年版テーブルを使用し、そのことをdata_sourceとlive_checkに記載します。

ツール

ツール返される内容
get_usps_holiday_shipping_deadlines12月25日までに届けるための、2026年のUSPS発送日すべてです。米国本土48州、アラスカ、ハワイ、プエルトリコおよび準州、9つの国際地域、APO/FPO/DPOのZIPコードグループが対象です。今日からの日数(米国東部時間)も含まれます。
check_holiday_ship_by_date発送日(デフォルトは今日)と宛先(「lower48」、州または準州、国、USPS地域、APO ZIP)のそれぞれについて、発送日、残り日数、まだ間に合うかどうか、さらに間に合うサービスのうち最も遅いサービスを返します。
get_military_mail_deadline1つのAPO/FPO/DPO ZIPコード(090-099、340、962-966)の発送日です。

各結果には、構造化されたJSON、1段落の要約、as_of、source、more(mcpstamp.com上のページ)が含まれます。

モデルが知らない情報

  • 今年の日付です。USPSは毎年秋に新しい発送日を公開するため、モデルが記憶している日付は昨年のものです。
  • 今日の日付(米国東部時間)なので、「あと何日ありますか?」に正確に答えられます。
  • 細かな条件です。アラスカとハワイ向けのGround Advantageには一律の発送日はなく(USPSでは10日以上の配達予定期間が示されています)、Priority Mail Express MilitaryはAPO ZIP 093では利用できません。

インストール

ホステッド(Claude.aiのカスタムコネクタ、ChatGPTの開発者モード)

このURLを貼り付けてください。トークンも登録も不要です。すぐに利用できます。

https://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp
Claude Code
claude mcp add --transport http usps-holiday-deadlines https://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp
Claude Desktop

Claude Desktopでは、Settings、Connectors、Add custom connectorの順に選択してリモートサーバーを追加します。上記のURLを貼り付けてください。

Cursor

~/.cursor/mcp.jsonに追加します。

{
  "mcpServers": {
    "usps-holiday-deadlines": { "url": "https://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp" }
  }
}
VS Code

.vscode/mcp.jsonに追加します。

{
  "servers": {
    "usps-holiday-deadlines": { "type": "http", "url": "https://usps-holiday-shipping-deadlines-mcp.lipmichal.workers.dev/mcp" }
  }
}
ローカルstdio(npmリリース後)

npmパッケージはまだ公開されていません。公開後は、Node 20以降を使ってローカルで実行できます。

claude mcp add usps-holiday-deadlines -- npx -y usps-holiday-shipping-deadlines-mcp

プロンプトの例

  • 「クリスマスに間に合うように荷物を送るには、もう遅すぎますか?」
  • 「今年、USPSでクリスマスカードを送る最終日はいつですか?」
  • 「12月10日にドイツへ贈り物を送ります。クリスマスまでに届けられるUSPSのサービスはどれですか?」
  • 「クリスマスに間に合わせるには、APO 09021へいつ発送すればよいですか?」
  • 「ハワイ向けのUSPSのホリデーシーズン発送締切日はいつですか?」

データソース

取得日を含む一覧はDATA_SOURCES.mdをご覧ください。

制限事項

  • USPSの日付は配達予定日の推奨であり、保証ではありません。
  • 対象はUSPSのみです。UPSとFedExも独自のホリデーシーズン日程を公開していますが、各社のページは自動読み取りをブロックするため、含まれていません。
  • 国から地域への対応付けは、よく使われる約120か国を対象としています。それ以外の国は、USPSの地域名(「Europe」、「Middle East」など)で指定できます。
  • ホステッドサーバーはUSPSのページを最大6時間キャッシュします。

詳細

アシスタントだけでは答えられない質問に答える、その他のMCPサーバーについてはmcpstamp.comをご覧ください。

Zovo MCPコレクションの一部です:https://mcp.zovo.one

theluckystrikeが作成しました。

開発

npm install
npm test                              # builds, then runs the fixture tests and an offline stdio test
node scripts/stdio-transcript.mjs     # live stdio round trip, writes .live/stdio-transcript.jsonl

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。