freightgate-mcp-server

⚓ ShippingRates MCP 服务

面向 AI Agent 的集装箱运输情报 — 滞期费与滞箱费、本地费用、内陆运输、CFS 费率。通过 x402 使用 USDC 按请求付费。

快速开始

将 ShippingRates 添加到 Claude Desktop、Cursor 或任何兼容 MCP 的客户端：

{
  "mcpServers": {
    "shippingrates": {
      "url": "https://mcp.shippingrates.org/mcp"
    }
  }
}

就是这样。系统会自动发现 9 个工具：3 个免费工具和 6 个通过 x402 付费的工具。

v2.1.0 新增内容

• 双链支付 — Base Mainnet（EVM）+ Solana Mainnet
• 分级定价 — 根据数据复杂度，每次调用收费 $0.03 至 $0.25
• PayAI 促进器 — 免费，无需 API 密钥即可处理支付
• 23/23 个端点均已验证 — 已通过完整生产环境健康检查
• 2,547+ 条记录，涵盖 14 个数据库表
• 用于自动发现的服务卡片，位于 /.well-known/mcp/server-card.json
• 带实时支付追踪的实时分析仪表板
• 已上架 Official MCP Registry、Smithery、Glama、mcp.so、x402scan

工具

付费（通过 x402 使用 USDC）

工具	价格	描述
dd_calculate	$0.10	计算滞期费与滞箱费 — 免用期、每日费率、分段明细和总费用
dd_compare	$0.25	一次调用即可比较全部 6 家船公司的滞期费与滞箱费。没有竞品提供此功能。
local_charges	$0.05	港口本地费用 — THC、文件费、提单费、封条费
inland_search	$0.03	按起点和目的地搜索内陆运输路线
cfs_tariffs	$0.05	按货物类型查询集装箱货运站处理费率
inland_haulage	$0.05	内陆运输费率 — 从港口到目的地的卡车/铁路运输

免费

工具	描述
list_lines	列出全部 6 家船公司及各国记录数量
get_stats	数据库统计信息 — 记录数、覆盖范围、定价、最近更新
health_check	服务状态、版本、网络配置

支付

ShippingRates 使用 x402 协议 — 这是互联网为 AI Agent 提供的原生支付标准。

• 货币： USDC（稳定币，始终为 $1.00）
• 网络： Base Mainnet（EVM）+ Solana Mainnet
• 促进器： PayAI — 免费，无需 API 密钥
• 结算： 即时（约 200ms）
• 无需 API 密钥、账户或订阅

您的 Agent 发送请求 → 收到包含支付条款的 HTTP 402 响应 → 签署 USDC 支付 → 携带支付证明重试 → 获取数据。x402 客户端库会自动处理整个流程。

支持的 x402 客户端库

• TypeScript： @x402/fetch 或 @x402/axios
• Python： x402 软件包（httpx / requests）
• Go： x402 Go 模块

支付钱包

网络	地址
Base (EVM)	0x8c9e0882b4c6e6568fe76F16D59F7E080465E5C8
Solana	Gcv56hKWuEGmXheBpJxAwQxvX6QAMimZzzVrHaVCbNWE

数据覆盖范围

指标	数值
船公司	6 家 — Maersk、MSC、CMA-CGM、Hapag-Lloyd、ONE、COSCO
记录	2,547+ 条经验证的费率记录，涵盖 14 个表
国家/地区	9 个 — IN、AE、SG、CN、MY、LK、PK、BD、TH
集装箱类型	20DV、40DV、40HC、20RF、40RF、20OT、40OT、20FR、40FR
数据质量	100% 根据承运商官方 PDF 手动核验
数据表	dd_tariffs、local_charges、inland_haulage、cfs_tariffs、ports 等

API 访问

直接集成 API（不使用 MCP）：

资源	URL
API 基础地址	https://api.shippingrates.org
完整文档	https://api.shippingrates.org/llms-full.txt
LLMs.txt	https://api.shippingrates.org/llms.txt
x402 发现	https://api.shippingrates.org/.well-known/x402.json
MCP 服务	https://mcp.shippingrates.org/mcp
MCP 服务卡片	https://mcp.shippingrates.org/.well-known/mcp/server-card.json
健康检查	https://api.shippingrates.org/health

示例：D&D 计算

# Free endpoint — no payment needed
curl https://api.shippingrates.org/api/stats

# Paid endpoint — returns HTTP 402 with payment instructions
curl -X POST https://api.shippingrates.org/api/dd/calculate \
  -H "Content-Type: application/json" \
  -d '{"line": "maersk", "country": "IN", "container_type": "40HC", "days": 14}'

示例响应（D&D 计算）

{
  "line": "maersk",
  "country": "IN",
  "container_type": "40HC",
  "days": 14,
  "free_days": 4,
  "currency": "USD",
  "slabs": [
    { "from": 5, "to": 7, "rate_per_day": 7.5, "days": 3, "cost": 22.5 },
    { "from": 8, "to": 14, "rate_per_day": 15, "days": 7, "cost": 105 }
  ],
  "total_cost": 127.5
}

示例响应（D&D 比较）

{
  "country": "IN",
  "container_type": "40HC",
  "days": 14,
  "comparisons": [
    { "line": "maersk", "total_cost": 127.5, "free_days": 4, "currency": "USD" },
    { "line": "msc", "total_cost": 150.0, "free_days": 3, "currency": "USD" },
    { "line": "cosco", "total_cost": 95.0, "free_days": 7, "currency": "USD" }
  ],
  "cheapest": "cosco",
  "savings_vs_most_expensive": 55.0
}

架构

┌─────────────────────────────────────────────────────┐
│                   AI Agent / Client                  │
│            (Claude, Cursor, ChatGPT, etc.)           │
└──────────────┬──────────────────────┬───────────────┘
               │ MCP                  │ HTTP + x402
               ▼                      ▼
┌──────────────────────┐  ┌──────────────────────────┐
│  MCP Server v1.1.0   │  │    API Server v2.1.0     │
│  mcp.shippingrates   │──│  api.shippingrates.org   │
│  .org:3480           │  │  :3402                   │
└──────────────────────┘  └────────────┬─────────────┘
                                       │
                          ┌────────────▼─────────────┐
                          │  Shipping Intelligence DB │
                          │  SQLite — 14 tables       │
                          │  2,547+ verified records   │
                          └──────────────────────────┘

• MCP 服务 — TypeScript、@modelcontextprotocol/sdk、Streamable HTTP 传输
• API 服务 — TypeScript、Express.js、搭配 PayAI facilitator 的 x402 v2 SDK
• 数据库 — SQLite，数据来自承运商官方资费 PDF
• 基础设施 — PM2 进程管理器、Cloudflare Tunnel，重启后仍可运行

使用场景

• 货运代理在预订前估算罚款成本
• AI Agent优化集装箱提货计划，尽量减少滞箱费和滞期费
• 物流公司比较承运商，寻找最便宜的方案
• 贸易融资评估进口业务的成本风险
• 供应链平台集成实时 D&D 数据

发现与目录

ShippingRates 已列入以下目录：

目录	状态
官方 MCP 注册表	✅ 已上线 — io.github.vinaybhosle/shippingrates-mcp-server
Smithery	✅ 已提交
Glama	✅ 已提交
mcp.so	✅ 已提交
x402scan	✅ 已索引 — 自动发现 6 个资源

关于

由 SmartBiz AI 构建——为商业航运提供 AI 解决方案，总部位于印度孟买。

ShippingRates 是全球首个原生支持 x402 的航运数据 API，专为 AI Agent 和自主商务打造。

链接

• 🌐 网站
• 📖 完整 API 文档
• 🔍 x402 发现
• ⚡ x402 协议
• 🤖 MCP 规范
• 📊 API 统计数据

许可证

此存储库仅包含文档和连接配置。ShippingRates API 和 MCP 服务是由 SmartBiz AI 运营的商业服务。

API 的使用遵循 x402 协议，按请求付费。