Aether-X Port Delay Intelligence

aetherx-mcp — 港口拥堵、海运物流与供应链 MCP 服务

Aether-X 是 Aether-X Port Congestion Oracle 的 MCP 服务，可为任何兼容 MCP 的 Agent（Claude Desktop、Cursor、VS Code、自定义大模型 Agent）提供全球贸易的港口拥堵、海运延误、船舶排队和供应链风险信号。它既能用通俗语言回答简单查询（“鹿特丹是否延误？”），也能在用于决策的工作流中以美元风险敞口呈现结果（滞期费、租船风险、航线间的财政套利）。

**关键词：**海运、航运、船舶、港口、港口拥堵、滞期费、货运、物流、供应链、ETA 延误、船舶排队、航运咽喉要道、苏伊士、巴拿马、贸易航线、货物、量化金融。

数据完整性声明：巴西港口（BRSSZ 桑托斯、BRPNG 巴拉那瓜、BRRIO 里约热内卢）提供实时作业船舶排队信息（data_source="live:appa+santos+lachmann"）；尼泰罗伊（BRNIT）和伊塔瓜伊（BRITG）以及里约热内卢提供来自 SILOG PortosRio 的实时船舶排队信息（data_source="live:portosrio_silog"）。其余港口提供静态参考种子数据（data_source="static_reference_seed"）。每个工具结果都包含 data_source 和 as_of。24/48/72 小时趋势是合成预测，并非实时预报。种子数据并非实时现场数据。

安装

pip install aetherx-mcp
# or run without installing (recommended for MCP clients):
uvx aetherx-mcp

配置 MCP 客户端

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "aetherx-oracle": {
      "command": "uvx",
      "args": ["aetherx-mcp"],
      "env": { "RAPIDAPI_KEY": "SUA_RAPIDAPI_KEY" }
    }
  }
}

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "aetherx-oracle": {
      "command": "uvx",
      "args": ["aetherx-mcp"],
      "env": { "RAPIDAPI_KEY": "SUA_RAPIDAPI_KEY" }
    }
  }
}

工具

工具	参数	返回值
get_port_operations_status	port_id（UN/LOCODE）	通俗易懂的状态（NORMAL / CONGESTED）、延误、等待船舶数量、数据来源信息，以及可选的决策层升级服务——免费观测
get_port_risk	port_id（UN/LOCODE）	拥堵评分、ETA 延误、等待船舶数量、货运波动性、每日滞期费估算
get_ports_risk	port_ids（列表）	同上，适用于整个投资组合，并行获取
get_port_trend	port_id（UN/LOCODE）	24 小时 / 48 小时 / 72 小时拥堵预测 + 趋势标签（加速 / 稳定 / 缓解拥堵）
list_supported_ports	—	35 个港口和航运咽喉要道（id、名称、国家）

每个响应都是类型化载荷：

{
  "port_id": "BRSSZ",
  "port_name": "Santos",
  "country": "Brasil",
  "congestion_score": 0.78,
  "eta_delay_days": 1.6,
  "waiting_vessels": 12,
  "freight_volatility_index": 0.42,
  "estimated_daily_demurrage_usd": 63200,
  "updated_at": "2026-09-17 15:46:53"
}

配置

变量	默认值	说明
RAPIDAPI_KEY	—	设置后，请求将通过 RapidAPI 网关路由（按量计费）
RAPIDAPI_HOST	aether-x-port-congestion-oracle.p.rapidapi.com	RapidAPI 主机
AETHERX_BASE_URL	https://aetherx.aether-grid.io	直连 API 基础 URL

未设置 RAPIDAPI_KEY 时，服务会直接调用公开的生产 API。

Agent 提示词示例

• “桑托斯港现在有延误吗？”（→ get_port_operations_status）
• “我的货物卡在哪里了？巴拉那瓜的等待时间是多少？”（→ get_port_operations_status）
• “未来 3 天鹿特丹的拥堵风险如何？”（→ get_port_trend、forecast_vessel_queue_delays）
• “按拥堵程度排列这些港口：BRSSZ、CNSHA、NLRTM、USLAX。”（→ get_ports_risk）
• “上海有多少艘船在等待？”（→ get_port_state、get_port_operations_status）
• “哪条航线能最大限度降低运往 MT 的化肥货物的滞期费和财政成本？”（→ evaluate_fiscal_routing，需要 M2M 密钥）

许可证

MIT——参见 LICENSE。这些信号按“原样”提供，不构成投资建议。请参阅服务条款。