MarineTraffic MCP サーバー

MarineTraffic 船舶追跡データへのアクセスを提供するモデルコンテキストプロトコル (MCP) サーバー。

特徴

この MCP サーバーは次の機能を提供します。

ツール

get_vessel_position : MMSIまたはIMO番号で船舶のリアルタイム位置を取得します
get_vessel_details : MMSIまたはIMO番号で船舶の詳細情報を取得します
search_vessels : 船舶を名前、MMSI、IMO、または船舶の種類で検索します
get_vessels_in_area : 指定された地理的エリア内の船舶を取得する

リソース

船舶://{識別子} : MMSIまたはIMO番号による船舶に関する情報
vessels://area/{lat}/{lon}/{radius} : 指定された地理的領域内の船舶のリスト

インストール

前提条件

Node.js 18以上
MarineTraffic API キー ( MarineTraffic API サービスから入手可能)

設定

このリポジトリをクローンするか、ソースコードをダウンロードしてください
依存関係をインストールします:

cd marinetraffic-server
npm install

サーバーを構築します。

npm run build

構成

サーバーが機能するにはMarineTraffic APIキーが必要です。これは環境変数MARINETRAFFIC_API_KEYを通じて提供できます。

MCP設定の構成

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

Claude デスクトップアプリ (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>

APIキーの制限

MarineTraffic APIには、ご契約のサブスクリプションプランに基づいた使用制限があります。サーバーをご利用の際は、これらの制限にご注意ください。クォータ超過を防ぐことができます。

トラブルシューティング

API キーエラー: MarineTraffic API キーが有効であり、環境変数に正しく設定されていることを確認してください。
レート制限：レート制限エラーが発生した場合、サーバーは指数バックオフで自動的に再試行しますが、追加のリクエストを行う前に待機する必要がある場合があります。APIを通じて利用可能な船舶の詳細情報の例

APIキーの制限

トラブルシューティング

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

ライセンス

このプロジェクトは ISC ライセンスに基づいてライセンスされています。

MarineTraffic MCP Server