Imf Portwatch

mcp-imf-portwatch

IMF PortWatch MCP — 世界の海上貿易と海上交通の要衝に関するシグナル（無料、認証不要）

Pipeworx の一部です。AI エージェントを1881以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとの提携、承認、公開を受けたものではありません。

ツール

ツール	説明
chokepoints_list	PortWatch が追跡する主要な海上チョークポイント 8 か所（スエズ、パナマ、ボスポラス、ジブラルタル、ドーバー、マラッカ、ホルムズ、バブ・エル・マンデブ）を、年間船舶数、貨物タイプ別の交通量の内訳（コンテナ／ドライバルク／タンカー／RoRo／一般貨物）、貨物量上位の業界とともに一覧表示します。チョークポイントが通常どのような貨物を運んでいるかを確認するのに使います。日次のリアルタイム交通量については、chokepoint_daily_traffic を呼び出してください。
chokepoint_daily_traffic	特定のチョークポイントを通過する船舶の日次数と総積載能力（載貨重量トン数）を取得します。時系列データを新しい順に返し、貨物タイプ別（コンテナ／ドライバルク／一般貨物／RoRo／タンカー）の内訳も含みます。「フーシ派の攻撃後、スエズの交通量は通常に戻ったか」「ホルムズの通過量は過去 30 日平均と比べてどうか」など、チョークポイントの混乱が続くことを前提とする予測に使います。わかりやすい名前（suez / panama / hormuz / bab-el-mandeb / など）または PortWatch の portid（chokepoint1..8）を指定できます。
port_search	PortWatch の港データベース（世界 1,500 以上の港）を、港名、国名、ISO3 で検索します。一致する港について、国、大陸、緯度／経度、貨物タイプ別の年間船舶数、貨物量上位の業界、およびその港が当該国の海上輸入／輸出に占める割合を返します。国レベルの混乱で影響を受ける港の特定や、港名から LOCODE ／ portid を探すのに便利です。
recent_disruptions	PortWatch が追跡する港に影響を与える混乱イベント（熱帯低気圧、洪水、地震、紛争イベント）を、開始／終了日、警戒レベル（GREEN/ORANGE/RED）、深刻度、影響を受けた港の数、影響を受けた人口とともに取得します。国、警戒レベル、年で絞り込めます。「過去 1 か月に海運を妨げたものは何か」「サプライチェーンに影響した港湾閉鎖はどれか」の確認や、現在の混乱が深刻化しているかという予測の検証に使います。
chokepoint_status	1 か所の海上チョークポイントの交通状況を取得します。直近の確定済み通過日について、過去の基準値と比較して評価するため、エージェントはその海峡や運河の交通量が通常のペースを上回っているか、下回っているか、通常どおりかをひと目で把握できます。「ホルムズ海峡を通る船舶は減っているか」「今週のスエズ運河通過量」「パナマ運河の船舶数は平常時と比べてどうか」「海上チョークポイントの混乱状況を確認」「バブ・エル・マンデブでタンカー交通量に異常はあるか」といった質問に答えます。最新日のデータ（船舶総数、船種別の数、総積載能力を示す載貨重量トン数）、data_lag_days と freshness_note、基準値の平均と差分／偏差率／方向（上回る、下回る、通常）、7 日間および 30 日間の平均、船種別（タンカー、コンテナ、ドライバルク、一般貨物、roro）の同じ偏差率（ホルムズでタンカーのみが減少するのは、取引可能なシグナルです）、さらに期間内の日次総数の最小値と最大値、およびそれぞれの日付を返します。情報源は IMF PortWatch の AIS 由来の日次通過数で、数日の遅れを伴って公開されるため、「最新」日はリアルタイムの数ではなく、直近の確定済みの日付です。許容度の高い名前（「Hormuz」、「Strait of Hormuz」、「hormuz」、「Suez」、「Panama」、「Bab el-Mandeb」、「Malacca」、「Taiwan」、「Bosphorus」、「Gibraltar」、「Dover」）または「chokepoint6」のような PortWatch の portid を指定できます。使用例：chokepoint_status({chokepoint: "Hormuz"}); chokepoint_status({chokepoint: "Suez Canal", baseline_days: 30}); chokepoint_status({chokepoint: "Panama"})。
chokepoint_compare	2～6 か所の海上チョークポイントの交通状況を並べて比較し、それぞれが過去の基準値からどれだけ逸脱しているかを順位付けするため、エージェントは異常がある海峡や運河を特定できます。「現在、混乱している海上チョークポイントはどれか」「スエズ運河の通過量とバブ・エル・マンデブの比較」「パナマ運河の船舶数とホルムズの比較」「チョークポイント全体でのタンカー交通量の異常」といった質問に答えます。各チョークポイントについて、直近の確定済みの日付とその日の総数、期間中の基準値の平均、差分、偏差率、方向（上回る、下回る、通常）、船種別の偏差率を返します。結果は絶対偏差が大きい順に並びます。比較全体の data_lag_days と freshness_note も報告します。情報源は IMF PortWatch の AIS 由来の日次通過数で、数日の遅れを伴って公開されるため、「最新」の数値はすべてリアルタイムの数ではなく、直近の確定済みの日付のものです。名前は柔軟に照合され（「Hormuz」、「Strait of Hormuz」、「Suez」、「Panama」、「Bab el-Mandeb」、「Malacca」、「Taiwan」、「Bosphorus」、「Gibraltar」、「Dover」）、portid も指定できます。使用例：chokepoint_compare({chokepoints: ["Hormuz", "Suez", "Bab el-Mandeb"]}); chokepoint_compare({chokepoints: ["Suez", "Cape of Good Hope"], days: 90}); chokepoint_compare({chokepoints: ["Panama", "Suez", "Malacca", "Hormuz"], days: 14})。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "imf-portwatch": {
      "url": "https://gateway.pipeworx.io/imf-portwatch/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/imf-portwatch/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使える一連のツール）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントでは、そのパック独自のツールに加えて、共有ツールが約 30 個表示されます。接続の initialize 応答には正確な対象範囲が示されており、その日の状況を判断する際の確定情報です。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うことで、このパックの対象外の質問にも、カタログ全体を対象に振り分ける ask_pipeworx 経由で回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1881+ 件のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworx を使えば、どちらからでもすべてのツールを利用できます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/chokepoints_list \
  -H 'Content-Type: application/json' \
  -d '{}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/chokepoints_list を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です：

{
  "mcpServers": {
    "imf-portwatch": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-imf-portwatch"]
    }
  }
}

または、起動を確認するために直接実行します：

npx -y @pipeworx/mcp-imf-portwatch

stdin/stdout 経由で MCP を処理し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Imf Portwatch data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT