SMKlog Parcel Shipping Rates

SMKlog 包裹运输费率 — MCP 服务

查询从美国寄出的包裹的 USPS、UPS、FedEx 和 DHL Express 实时报价——美国国内，或寄往加拿大、英国、德国或澳大利亚——只需用通俗语言描述包裹。
无需称重。无需账户。无需 API 密钥。

https://quote-api.smklog.com/mcp · streamable-http · MCP 2026-07-28, 2025-06-18, 2025-03-26

---

大多数运输 API 都需要提供纸箱信息：长、宽、高、重量。人们通常没有 这些数据——他们只有桌上的一件物品，以及要寄往的 ZIP 邮编。本服务 可以接收物品描述。

描述**“一把装在硬盒里的全尺寸原声吉他”**，它便会估算包装纸箱尺寸，实时比较三家承运商的价格，并返回你实际可以买到的服务——并列显示结账总价，以及承运商公布的同一包裹柜台价格（如有），让你始终可以向他人展示这两个价格。

你可以向助手询问

• “从 07922 寄一个 12 lb 的箱子到 90011 要多少钱？”
• “从新泽西州寄一把装在硬盒里的全尺寸原声吉他到洛杉矶要多少钱？”
• “比较从纽瓦克寄一个 5 lb 箱子到芝加哥的 USPS、UPS 和 FedEx 价格——哪个最便宜，哪个最快？”
• “计算一个 24 × 18 × 12 in、重 22 lb 的箱子寄到 33101 的价格，然后给我一个购买面单的链接。”
• “我的包裹到哪了？追踪号是 9400111899561234567890。”
• “那个面单他们付款了吗？这是你给我的会话 ID。”
• “过去几个月，寄一个 5 lb 的箱子到丹佛要多少钱？”

工具

工具	功能说明
get_parcel_quote	查询从美国境内寄出的一件包裹的实时运费，可寄往美国境内或加拿大、英国、德国、澳大利亚；支持 USPS、UPS 和 FedEx，另支持 DHL Express 寄往德国和澳大利亚。输入自然语言描述，即可估算包装后的箱子；也可传入准确尺寸和重量以跳过估算。最多返回五种可购买的服务，包括结账总价（已包含 SMKlog 费用）、有公布价格时并列显示的承运商柜台价，以及预计送达时间范围。
create_checkout_link	为货件计价并返回支付会话信息：金额、一个会打开 SMKlog 结账页面且已填入此货件信息的交接 URL，以及 session_id。用户需在结账页面确认内容申报和承运商调整同意事项，并通过 Stripe 付款。
get_checkout_status	查询支付会话状态：awaiting_checkout、checkout_started、paid、label_ready（含追踪号码）、delivered 或 refunded。状态读取自订单记录，不会调用承运商，也不会包含姓名、地址或电子邮件。会话信息保留 30 天。
track_parcel	查询在 smklog.com 购买标签的货件的配送状态、扫描事件和承运商预计送达日期。并非适用于任意追踪号码的通用追踪器。
get_price_index	SMKlog 每月包裹价格指数：从新泽西州纽瓦克寄往美国五座城市的六种常见箱型（1–20 lb），通过为实际货件定价的同一实时流程重新计价。读取该指数不会消耗报价额度。

接入前值得了解的事项

报价会调用真实的承运商接口，生成报价也会产生实际费用。 每件货物调用一次 get_parcel_quote，不要对你感兴趣的每种变化都分别调用一次。 服务会对每个客户端实施速率限制，并会明确告知你，而不是悄悄降低服务质量。

寄件地必须在美国。 支持美国境内线路和从美国寄出的国际货件。起点在其他地方的线路不在服务范围内，服务会明确告知你，而不会编造价格。

价格是已包含 SMKlog 费用的结账总价。 费用明细仅显示在结账收据上；费率旁返回的价格是承运商对同一包裹公布的柜台价——也就是寄件人前往承运商柜台办理时需要支付的价格。结账总价才是实际应付金额。

仅支持包裹，每箱一张标签。 超出包裹限制，或描述为托盘或货运的货件，将返回 mode: not_a_parcel，且不提供费率：SMKlog 仅销售包裹标签，不安排托盘或货运。如果多个商品单位可以装进一个箱子，则按一个箱子计价；如果需要多个箱子，或 quantity 大于 1 且同时提供了描述一个箱子尺寸的准确尺寸，则会返回 mode: multiple_boxes，且不提供费率。请分别为每个箱子获取报价。

这里的任何操作都不会直接购买标签。 create_checkout_link 会生成一个 URL；用户需自行完成购买、申报内容并同意承运商调整。Agent 无法通过此服务代他人付款。

连接

{
  "mcpServers": {
    "smklog": {
      "type": "http",
      "url": "https://quote-api.smklog.com/mcp"
    }
  }
}

无需密钥、OAuth 或注册。报价、追踪和价格指数均开放使用。

通过 stdio

对于只启动本地命令的客户端——Claude Desktop、Cursor、MCP 检查器、基于 Docker 的运行器——本仓库是连接到同一端点的轻量级 stdio 桥接程序。无需依赖、无需构建、无需密钥：

{
  "mcpServers": {
    "smklog": {
      "command": "npx",
      "args": ["-y", "github:smklog/parcel-shipping-rates-mcp"]
    }
  }
}

也可以使用 Docker：

docker build -t smklog-parcel-shipping-rates-mcp https://github.com/smklog/parcel-shipping-rates-mcp.git
docker run -i --rm smklog-parcel-shipping-rates-mcp

桥接程序会将每条 JSON-RPC 消息转发到 https://quote-api.smklog.com/mcp，并将响应写回，每行一个 JSON 对象。它还会将 2026-07-28 路由信封映射到 HTTP 标头（MCP-Protocol-Version、Mcp-Method、Mcp-Name），并在旧版路径上发送协商出的 initialize 版本，因此两个协议时期都能通过它正常工作。如果无法连接端点，它仍会根据此处附带的快照（initialize.json、tools.json）响应 initialize 和 tools/list，让你查看可用内容；调用工具则需要网络。npm test 会进行端到端测试。

配置

桥接程序只读取三个可选环境变量，不读取其他内容：

变量	默认值	作用
SMKLOG_MCP_URL	https://quote-api.smklog.com/mcp	桥接程序转发请求的端点。
SMKLOG_MCP_TIMEOUT_MS	90000（最小值为 1000）	每个请求的超时时间。报价需要实时调用承运商，可能耗时半分钟。
SMKLOG_MCP_DEBUG	未设置	设为 1 时会将流量摘要写入 stderr；stdout 保持为干净的 JSON-RPC。

{
  "mcpServers": {
    "smklog": {
      "command": "npx",
      "args": ["-y", "github:smklog/parcel-shipping-rates-mcp"],
      "env": { "SMKLOG_MCP_TIMEOUT_MS": "120000" }
    }
  }
}

密钥与凭据

无需配置任何密钥。服务器不需要 API 密钥、令牌或账户，桥接程序也不会读取凭据。请勿在此服务器的客户端配置中填写承运商、支付或其他 API 密钥：没有任何程序会读取它们，而且配置文件并不适合存放密钥。承运商和支付凭据仅保存在服务器端。

数据与隐私

• 报价工具会获取商品描述、邮政编码，以及可选的箱子尺寸和重量。它们绝不会询问街道地址、姓名、电子邮件或电话号码。姓名、地址和付款信息由用户在 smklog.com 结账时填写，而不是通过此服务器提交。
• 商品描述和箱子信息用于向承运商查询包裹价格。对于已识别的商品，我们会将其保存在商品目录中，以便下次为同一商品报价时得到相同结果。
• 每次工具调用都会记录 30 天：工具、商品描述、每个邮政编码的前三个字符、目的地国家/地区、客户端软件类别、请求所在国家/地区以及结果。不会因此存储 IP 地址、完整的用户代理、街道地址或联系方式。
• 速率限制按小时统计请求，并以连接方 IP 的单向 SHA-256 哈希值（以及 IP 和用户代理的组合哈希值）作为键；不会记录 IP 地址本身。
• 完整政策：https://smklog.com/privacy。

也可从 Smithery 安装，并已在 官方 MCP 注册表 中登记，名称为 com.smklog/parcel-shipping-rates。

如果不使用 MCP 传输，还可通过以下方式访问： OpenAPI · A2A Agent 卡片 · API 文档 · llms.txt

运营方

SMKlog 销售美国境内的运输标签。此服务器使用的定价流程与网站相同，不存在单独的“API 价格”。不使用助手的用户也可以通过运费计算器为相同的标签询价并购买。

如有问题、错误或异常结果，请联系：[email protected]。 安全问题报告：请参阅 SECURITY.md。变更记录：CHANGELOG.md。