Aether-X Port Delay Intelligence

aetherx-mcp — 港湾混雑、海運物流、サプライチェーン MCP サーバー

Aether-X は、Aether-X Port Congestion Oracle 向けの MCP サーバーです。MCP 対応エージェント（Claude Desktop、Cursor、VS Code、カスタム LLM エージェント）に、グローバル貿易の港湾混雑、海上輸送の遅延、船舶の待ち行列、サプライチェーンリスクのシグナルを提供します。簡単なクエリ（「ロッテルダムは遅れていますか？」）には平易な言葉で、意思決定に役立つワークフロー（滞船料、用船リスク、航路間の財政裁定取引）には米ドル建てのエクスポージャーで回答します。

キーワード： 海運、輸送、船舶、港湾、港湾混雑、滞船料、貨物輸送、物流、サプライチェーン、到着予定時刻の遅延、船舶の待ち行列、チョークポイント、スエズ運河、パナマ運河、貿易航路、貨物、定量ファイナンス。

データ整合性に関するお知らせ：ブラジルの港湾（BRSSZ Santos、BRPNG Paranaguá、BRRIO Rio de Janeiro）では、運航中の船舶リストをリアルタイムで取得します（data_source="live:appa+santos+lachmann"）。Niterói（BRNIT）および Itaguaí（BRITG）は、Rio de Janeiro とともに 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）	混雑スコア、到着予定時刻の遅延、待機中の船舶数、運賃の変動性、1 日あたりの滞船料の推定額
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 を直接呼び出します。

エージェントのプロンプト例

• 「Santos 港は今、遅れていますか？」（→ get_port_operations_status）
• 「貨物はどこで滞留していますか？Paranaguá の待ち時間はどのくらいですか？」（→ 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 を参照してください。シグナルは「現状有姿」で提供され、投資助言を構成するものではありません。利用規約を参照してください。