Postage Stamp Price MCP

postage-stamp-price-mcp

为 AI 助手提供邮票价格查询。询问一枚 Forever 邮票的价格、寄送 40 张方形节日贺卡需要多少邮资，或寄一封信到德国需要多少钱，即可获取当前 USPS 价格及其生效日期。

这是一个 Model Context Protocol（MCP）服务。它会在调用时读取 Postal Explorer 上的 USPS Notice 123 官方零售价格表。价格根据每个价格单元格中的 USPS SKU 匹配。无需 API 密钥。

工具

工具	返回内容
get_stamp_price	当前 Forever 邮票价格（1 盎司 First-Class Mail 信件）、2、3 和 3.5 盎司价格、邮资机价格、明信片价格、1 盎司大信封价格、不可机械分拣附加费，以及 1 盎司国际信件（Global Forever）价格，并附生效日期。
calculate_letter_postage	按重量计算寄往美国、加拿大、墨西哥或其他国家的信件、明信片或大信封邮资，包含不可机械分拣附加费、指定数量的总邮资，以及每件所需的 Forever 邮票数量。
get_flat_rate_prices	Priority Mail 和 Priority Mail Express 定额信封及箱子的零售价格。

每个结果都包含结构化 JSON、一段摘要、as_of、source 和 more（mcpstamp.com 上的页面）。

它掌握了你的模型不知道的信息

• 今日生效的价格。USPS 每年会调整一到两次价格，因此记忆中的邮票价格往往不准确。
• 价格表的生效日期，因此答案可以说明价格从何时开始生效。
• 附加费和重量档位，因此对于“该用两枚邮票还是一枚？”这类问题，可以给出准确答案。

安装

托管版（Claude.ai 自定义连接器、ChatGPT 开发者模式）

粘贴此 URL。无需令牌，也无需注册。现在即可使用。

https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http stamp-price https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp

Claude Desktop

Claude Desktop 可通过 Settings、Connectors、Add custom connector 添加远程服务。粘贴上面的 URL。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "stamp-price": { "url": "https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp" }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "stamp-price": { "type": "http", "url": "https://postage-stamp-price-mcp.lipmichal.workers.dev/mcp" }
  }
}

本地 stdio（npm 发布后）

npm 包尚未发布。发布后，可使用 Node 20 或更高版本在本地运行：

claude mcp add stamp-price -- npx -y postage-stamp-price-mcp

示例提示词

• “现在一枚邮票多少钱？”
• “寄送 40 张重 1.2 盎司的方形圣诞贺卡需要多少邮资？”
• “寄一封信到德国要多少钱？”
• “中号定额箱多少钱？”
• “明信片邮票多少钱？”

数据来源

完整列表及获取日期见 DATA_SOURCES.md。

• USPS Notice 123 Price List，在调用时读取。

限制

• 仅包含邮局零售价格。商业价格、邮资机价格和 Click-N-Ship 价格可能更低；已包含邮资机信件价格。
• 不涵盖包裹（Ground Advantage、按区域划分的 Priority Mail），定额服务除外。如需查询这些价格，请使用 https://postcalc.usps.com/。
• 暂不涵盖国际大信封。
• 托管服务最多会缓存价格表 6 小时。

更多信息

更多可回答助手自身无法解答问题的 MCP 服务，请访问 mcpstamp.com。

本项目属于 Zovo MCP collection：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