服务器运行方式工具预订需求报价有效期范围
Warp warp-agent-mcp使用 npx 运行 stdio~23API 密钥约72小时道路,自有网络
CargoAi CargoMART托管搜索,报价,预订账户认证短窗口空运
freightutils-mcp使用 npx 运行 stdio~19否(只读)不适用计算,参考
Easyshiphosted or stdio费率、标签、追踪API 密钥运营商依赖包裹

几个月前,我写了一篇关于 模型上下文协议如何映射到货运 API 的入门指南,其中包含了一个你可以自行运行的最小化服务器。MCP 是 Anthropic 于 2024 年 11 月发布的开放标准,货运公司直到 2026 年初才缓慢采用。自那时起,讨论停止,交付开始。Warp 于 2026 年 4 月 16 日以 MIT 许可证在 npm 上发布了 warp-agent-mcp,CargoAi 于 2026 年 6 月 5 日推出了其 CargoMART 服务器,开源和包裹服务器也随之问世。这是我一直想读的文章:对实际交付内容的拆解,它们四家在哪些方面达成一致,以及设计选择在哪些地方悄然分歧。如果你还没有看过协议基础知识,请先从那篇入门指南开始,然后再回到这里。

实际发货的服务器

  • \tWarp warp-agent-mcp 于 2026 年 4 月 16 日登陆 npm,采用 MIT 许可,号称是首个用于预订真实货运的 MCP 服务器。它提供了约 23 种工具,涵盖了针对 Warp 自有管理道路网络的搜索、报价、预订和跟踪功能。
  • CargoAi CargoMART 于 2026 年 6 月 5 日发货,允许代理在 Copilot、ChatGPT、Claude 或 Gemini 内部搜索、报价和预订空运。这是航空业正在发展的最明显信号,而不仅仅是公路运输。
  • freightutils-mcp 是开源选项,一个包含大约 19 个免费实用工具的 TypeScript 包。它侧重于计算和参考数据,而不是在实时网络上进行交易,这使其成为一个干净的沙箱。
  • **Easyship** 专注于其 550 多个快递集成服务的包裹和小件运输,提供费率、标签创建和追踪。它以包裹优先,因此其建模假设与重货运输有所不同。

并排阅读,这四者在三个问题上存在分歧:代理在没有凭证的情况下能做什么,价格有效期是多久,以及服务器运行在哪里。

The servers that actually shipped

工具表面:代理被允许做什么

每台服务器都是一个工具集,而这个工具集则揭示了供应商的意图。Warp的大约23个工具是最广泛的集合,因为它旨在实现端到端的交易,从容量搜索到追踪查询。CargoMART则专注于空运订票流程,提供搜索、报价和预订功能。freightutils 的19个工具则集中在计算和查询领域。Easyship 通过费率、标签和追踪来优化包裹费率到标签的流程。

Tool surface: what the agent is allowed to do

当我将它们映射到货运工作流程时,这些工具会聚合为四项工作:寻找运力、为其定价、确认运力以及跟踪运力。前两项仅读取信息,因此风险较低。确认则会写入现实世界并花费金钱。跟踪再次变为只读,但价值很高,因为大部分人力时间仍然花在查询状态上。

代理通过 MCP tools/list 方法发现服务器提供了什么,然后使用 tools/call 调用工具,因此它读取回来的名称很重要。那些描述调度程序能识别的输出的名称,例如 get_quotebook_shipmentget_tracking,可以经受住与真实代理的交互。暴露原始端点的名称会迫使模型编排底层实现,也正是在这种情况下,虚构的参数才会出现。Warp 和 CargoMART 都倾向于使用以输出命名的工具,这是一个隐含的信号,表明它们是专为代理设计的,而不是从 REST 规范改造而来的。

身份验证:开放报价,有约束的预订

那些严肃的服务器之间存在的共同模式正是我自己会选择的那种。引用和参考工具是开放的或低门槛的,因为让代理定价一条车道是无害且非常实用的。预订、取消以及任何涉及发票的操作都受到 API 密钥或完整的 OAuth 流程的保护。例如,Warp 从本地配置文件 ~/.warp/config.json 中读取其密钥,因此只有在您经过身份验证时,预订工具才会亮起。

Authentication: open quoting, gated booking
{
  "mcpServers": {
    "warp": {
      "command": "npx",
      "args": ["-y", "warp-agent-mcp"],
      "env": { "WARP_API_KEY": "your_key_here" }
    }
  }
}

没有密钥,代理人仍可以进行探索和引用。有了密钥,代理人就可以代表您花费金钱。对于桌面使用,配置文件中的静态密钥是可以接受的。对于无监督预订的生产代理,静态密钥会带来风险,而您会希望使用 OAuth 2.1(附带 PKCE)和作用域受限、可撤销的令牌,这样一来,代理人一旦被泄露,就无法随意重新预订或取消。我将在专门的安全文章中更深入地探讨这一点,因为货运预订会将普通的提示注入转化为金钱事件。

引用有效性陷阱

以下是初次接触货运的团队会遇到的细节。报价不等于价格,价格有有效期。例如,Warp的报价有效期大约为72小时,而不是几天。如果代理商周一报价,周五尝试预订,将会失败,而一个天真的重试循环会持续失败并消耗掉token。

所以服务器必须使有效性机器可读,并且您的代理必须遵守它。好的实现会返回明确的到期时间和报价引用,预订工具会同时检查这两者。较弱的实现会返回一个简单的数字,让您自行猜测。当您评估服务器时,请引用一个车道,等待,然后尝试针对过时的报价进行预订。它的失败方式会告诉您投入了多少生产加固。

传输:stdio 与托管 HTTP

该协议定义了两种传输方式:stdio 和 Streamable HTTP,并且两种方式的消息都是 JSON-RPC 2.0。本地 stdio 服务器(使用 npx 启动)非常适合开发者将 Claude Desktop 或 Cursor 等桌面助手与其自己的账户连接。设置非常简单,凭证也绝不会离开本地机器。托管的 HTTP 服务器作为一项服务运行,这适用于需要代理集群共享访问、需要集中日志记录以及无法将 API 密钥分发到多台笔记本电脑的情况。

freightutils 和 npx 启动的服务器使本地路径变得轻而易举。生产部署倾向于托管在网关后面的 HTTP,该网关处理身份验证、速率限制和审计跟踪。两者都无可厚非。错误是将 stdio 原型部署到生产环境中,却发现你无法集中查看你的代理预订了哪些内容。

多载波市场服务器必须公开什么

这便是我的个人观点所在,因为我们运营的是一个市场,而不是单一的运营商。因此,建模问题确实有所不同。单一运营商的服务器只需要回答一个问题:我能否将此(货物)运送,以及在我的网络上运送的费用是多少。而市场服务器必须回答一个更难的问题:在众多运营商中,代理人应该选择哪个选项,以及为什么。

这迫使工具具备了单载波服务器从不需要的功能。代理必须能够比较报价,而不仅仅是获取一个。它需要一个将价格、运输时间和承运商可用性相结合的排名信号,因为在没有人服务的航线上最便宜的报价是一个陷阱。它需要真实的可用性,这样代理就不会承诺已经没有的运力。并且它需要已预订的货运能够追溯到特定的承运商和参考号,以便跟踪能够真正解决问题。在繁忙的航线上,代理可能会看到十几条报价,而当天只能预订三到四条,而且在我们收集的数据中,最便宜的报价和最便宜的可预订报价之间的差距是真实且经常出现的。隐藏这种差距的市场服务器是在亏待代理。我们不断重申的经验教训是,没有可用性的价格是营销,而不是预订。

如何评估货运MCP服务器

如果你要选择一个,请在实际运行的服务器上运行此简短清单,而不是在登陆页面上。

  1. 工具名称。它们是描述调度员可识别的输出,还是暴露了原始的端点?
  2. 凭证边界。无需密钥即可实现的功能,预订需要什么?是否存在无需人工干预的作用域 OAuth 路径?
  3. 报价有效期。到期日期是否明确返回,预订工具是否能干净利落地拒绝过时报价?
  4. 传输。 桌面本地 stdio,集群托管 HTTP。供应商是否支持你实际需要的那个?
  5. 保障誠信。 單一載體還是多個載體,如果是多個,代理商能否看到可用性和排名,而不是一個不透明的數字?
  6. **可观测性。**你能事后审计代理所引述和预订的内容吗?

市场在一个季度内就从“思考文章”转向了“套件”,即使按照物流科技的标准这也非常快。如果你正在开发,这份入门指南加上这次拆解分析,足以让你在本周内将一个代理部署到真实的网上。如果你正在购买,上面的清单可以帮你区分预订引擎和演示版本。在 获取传输 这样的市场中,同样的原则决定了一个代理是否值得信赖去花费资金,而这种信任建立在可用性和有效性之上,而不是工具列表的多少。

常见问题解答

什么是货运 MCP 服务器?

这是一个小型服务,将货运操作(例如报价、预订和跟踪)公开为 AI 助手可以通过模型上下文协议调用的工具,因此代理只需集成一次,而无需学习每个承运商的 API。

2026年有哪些货运 MCP 服务器?

值得关注的包括 Warp 的 warp-agent-mcp(用于陆路货运预订)、CargoAi 的 CargoMART(用于空运)、开源的 freightutils-mcp(用于计算和参考数据),以及 Easyship(用于包裹费率和标签)。

AI 代理可以在没有 API 密钥的情况下预订货物吗?

通常不会。大多数服务器允许代理在没有凭证的情况下查询和查找数据,但预订、取消和发票操作需要经过身份验证的金钥或 OAuth 令牌,因此只有授权代理才能花费金钱。

MCP 服务器返回的货运报价为什么会过期?

运费的价格受运力和燃油价格影响,因此报价的有效期非常短,有时只有几个小时。服务器会返回一个有效期,代理应重新预订新的报价,而不是重试一个过期的报价。

一个市场 MCP 服务器应该暴露,而单载波服务器不应暴露什么?

它应该让代理能够比较不同承运商的报价,查看一个结合了价格、运输时间和可用性的排名,并将预订与特定承运商进行核对,因为最便宜的报价并不总是实际可以预订的那个。