USPS Holiday Shipping Deadlines MCP

usps-holiday-shipping-deadlines-mcp

面向 AI 助手的 USPS 节日寄件截止日期。询问“现在寄圣诞包裹还来得及吗？”，即可获取 USPS 为每种邮件类别建议的最晚寄出日期、距今天还有多少天，以及哪种服务仍能在 12 月 25 日前送达。

这是一个模型上下文协议（MCP）服务。它会在调用时读取 USPS 节日寄件日期页面。无需 API 密钥。如果无法读取 usps.com，它会根据内置的 2026 年表格作答，并在 data_source 和 live_check 中说明。

工具

工具	返回内容
get_usps_holiday_shipping_deadlines	所有可在 12 月 25 日前送达的 2026 年 USPS 最晚寄出日期：美国本土 48 州、阿拉斯加、夏威夷、波多黎各和属地、九个国际地区，以及 APO/FPO/DPO ZIP 分组；并显示距今天还有多少天（美国东部时间）。
check_holiday_ship_by_date	对于寄件日期（默认为今天）和目的地（“lower48”、州或属地、国家、USPS 地区或 APO ZIP），列出每种服务的最晚寄出日期、剩余天数、是否仍能按时送达，以及仍能按时送达的最慢服务。
get_military_mail_deadline	一个 APO/FPO/DPO ZIP 编码（090-099、340、962-966）的最晚寄出日期。

每项结果都包含结构化 JSON、一段摘要、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 2026 Holiday Shipping Deadlines，在调用时读取。
• USPS service commitments 用于 ZIP 到 ZIP 的时效估算（提供链接，但不读取）。

限制

• 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