MarineTraffic MCP Server

MarineTraffic MCP サーバー

MarineTraffic の船舶追跡データにアクセスできる Model Context Protocol（MCP）サーバーです。

機能

この MCP サーバーでは、次の機能を利用できます。

ツール

• get_vessel_position：MMSI または IMO 番号を指定して、船舶のリアルタイムの位置を取得します
• get_vessel_details：MMSI または IMO 番号を指定して、船舶の詳細情報を取得します
• search_vessels：船名、MMSI、IMO、または船舶の種類で船舶を検索します
• get_vessels_in_area：指定した地理的エリア内の船舶を取得します
• get_port_calls：MMSI または IMO 番号を指定して、船舶の入港・出港履歴を取得します（2015-01-16 以降の日付のデータを利用できます）
• get_voyage_forecast：MMSI または IMO 番号を指定して、機械学習による船舶の航海予測を取得します。リアルタイムの AIS 位置情報と過去の航路を組み合わせ、次の寄港地と到着予定時刻を予測します

リソース

• vessel://{identifier}：MMSI または IMO 番号を指定して、船舶の情報を取得します
• vessels://area/{lat}/{lon}/{radius}：指定した地理的エリア内の船舶一覧を取得します
• port://{port_id}：MarineTraffic の港湾 ID または UN/LOCODE を指定して、港の最近の入港・出港履歴を取得します

インストール

Smithery 経由でのインストール

Smithery を使用して、MarineTraffic Vessel Tracking Server を Claude Desktop に自動インストールするには：

npx -y @smithery/cli install @Cyreslab-AI/marinetraffic-mcp-server --client claude

前提条件

• Node.js 18 以降
• MarineTraffic API キー（MarineTraffic API Services から取得できます）

セットアップ

1. このリポジトリをクローンするか、ソースコードをダウンロードします
2. 依存関係をインストールします：

cd marinetraffic-server
npm install

3. サーバーをビルドします：

npm run build

設定

このサーバーを使用するには、MarineTraffic API キーが必要です。環境変数 MARINETRAFFIC_API_KEY を使って設定できます。

MCP 設定

このサーバーを Claude で使用するには、MCP 設定ファイルに追加します。

Claude Desktop アプリ（macOS）の場合

~/Library/Application Support/Claude/claude_desktop_config.json を編集します：

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude VSCode 拡張機能の場合

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json を編集します：

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

使用例

サーバーの設定と起動が完了したら、Claude で船舶追跡データにアクセスできます。

船舶の位置を取得

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_vessel_position</tool_name>
<arguments>
{
  "identifier": "123456789"
}
</arguments>
</use_mcp_tool>

船舶を検索

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>search_vessels</tool_name>
<arguments>
{
  "vessel_name": "MAERSK"
}
</arguments>
</use_mcp_tool>

エリア内の船舶を取得

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_vessels_in_area</tool_name>
<arguments>
{
  "latitude": 37.8199,
  "longitude": -122.4783,
  "radius": 10
}
</arguments>
</use_mcp_tool>

船舶リソースにアクセス

<access_mcp_resource>
<server_name>marinetraffic</server_name>
<uri>vessel://123456789</uri>
</access_mcp_resource>

入港履歴を取得

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_port_calls</tool_name>
<arguments>
{
  "identifier": "123456789",
  "movetype": "arrival",
  "extended": true
}
</arguments>
</use_mcp_tool>

航海予測を取得（到着予定時刻）

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_voyage_forecast</tool_name>
<arguments>
{
  "identifier": "123456789"
}
</arguments>
</use_mcp_tool>

港湾アクティビティリソースにアクセス

<access_mcp_resource>
<server_name>marinetraffic</server_name>
<uri>port://22541</uri>
</access_mcp_resource>

API キーの制限

MarineTraffic API の使用量には、契約プランに応じた制限があります。サーバーを使用する際は、割り当て量を超えないようご注意ください。

get_port_calls と get_voyage_forecast は、MarineTraffic の Single Vessel Port Calls および Single Vessel Voyage Forecast サービスを呼び出します（AIS Data API Reference を参照）。これらは MarineTraffic の API カタログ にある個別料金の別サービスです。そのため、この 2 つのツールを利用するには、基本的な船舶位置情報だけでなく、該当するサービスを API キーで有効にする必要があります。有効な API キーであっても、これらのサービスが有効になっていない場合は呼び出しに失敗します。 API で利用できる船舶情報の詳細例

API キーの制限

MarineTraffic API の使用量には、契約プランに応じた制限があります。サーバーを使用する際は、割り当て量を超えないようご注意ください。

トラブルシューティング

• API キーのエラー：MarineTraffic API キーが有効で、環境変数に正しく設定されていることを確認してください。
• レート制限：レート制限エラーが発生した場合、サーバーは指数バックオフで自動的に再試行しますが、追加のリクエストを行う前に待機が必要な場合があります。
• データが見つからない場合：一部の船舶では、特に小型船舶や AIS の受信範囲が限られている海域にいる船舶では、リアルタイムの追跡データを利用できない場合があります。

ライセンス

このプロジェクトは ISC License のもとでライセンスされています。