Vesselapi Mcp Server

VesselAPI MCP サーバー

VessAPI の海事データを、Claude Desktop、Cursor、Windsurf、Claude Code などの AI アシスタントに公開する MCP（Model Context Protocol） サーバーです。

前提条件

1. dashboard.vesselapi.com でアカウントを作成します
2. ダッシュボードで API トークンを作成します
3. 以下の設定で、トークンを VESSELAPI_API_KEY として使用します

リソース：ドキュメント | API エクスプローラー | ダッシュボード | サポートへのお問い合わせ

機能

• 船舶、港、位置検索、排出量をカバーする 19 個のツール
• 船舶の検索、位置情報（単一および一括）、ETA、排出量、海難事故
• 港の検索と詳細情報、港のイベント（入港／出港）、対象となるすべての港を対象とした港イベント検索
• 地理的範囲による船舶検索（境界ボックスおよび半径）
• API クォータの使用量を制御する手動ページネーション

クイックスタート

インストールは不要です。npx を使って AI クライアントを設定します。

{
  "mcpServers": {
    "vesselapi": {
      "command": "npx",
      "args": ["-y", "vesselapi-mcp"],
      "env": {
        "VESSELAPI_API_KEY": "your-api-key"
      }
    }
  }
}

設定

上記の JSON をクライアントの設定ファイルに追加します。

クライアント	設定ファイル
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）
Cursor	.cursor/mcp.json または ~/.cursor/mcp.json
Claude Code	claude mcp add を実行すると、プロジェクト用に .mcp.json、ユーザー用に ~/.claude.json が書き込まれます
Windsurf	~/.codeium/windsurf/mcp_config.json

ツール

船舶ツール

ツール	説明
search_vessels	名前、IMO、MMSI、旗国、種類、コールサイン、または建造年で船舶を検索します
get_vessel	船舶の詳細情報を取得します
get_vessel_position	保存されている最新の船舶位置情報（緯度／経度、速度、進路、タイムスタンプ）を取得します。数時間から数日前の情報である場合があります
get_vessel_eta	船舶が最後に報告した ETA（予測ではなく申告値）を取得します
get_vessel_emissions	EU MRV の排出量報告（CO2、燃料消費量）を取得します
get_vessel_casualties	海難事故の記録を取得します
get_vessel_positions_batch	複数の船舶の位置情報を一度に取得します（時間範囲の指定は任意）

港湾ツール

ツール	説明
search_ports	名前、国、種類、規模、地域、港湾規模、または港湾用途で港を検索します
get_port	UN/LOCODE で港の詳細情報を取得します
get_port_inbound	ETA の時間枠内に、目的地としてその港を報告している船舶を取得します
get_port_events	港の入港／出港情報を取得します（timeFrom が指定されていない場合は直近 2 時間）
get_port_events_by_vessel	船舶の港イベントを取得します（timeFrom が指定されていない場合は直近 2 時間）
list_port_events	対象となるすべての港の港イベントを一覧表示し、時刻、国、港、船舶、イベント種別で絞り込みます
search_port_events_by_port	港名で港イベントを検索します
search_port_events_by_vessel	船舶名で港イベントを検索します
get_vessel_last_port_event	船舶の最新の港イベントを取得します

排出量ツール

ツール	説明
list_emissions	EU MRV の排出量報告を一覧表示します。報告年による絞り込みは任意です

位置情報ツール

ツール	説明
get_vessels_in_area	バウンディングボックス内にAIS位置情報がある船舶を検索します（デフォルトでは過去2時間、最大4時間）
get_vessels_in_radius	地点を中心とする半径内にAIS位置情報がある船舶を検索します（デフォルトでは過去2時間、最大4時間）

ページネーション

すべてのリストエンドポイントは、手動でページネーションを行うための limit パラメーターと nextToken パラメーターに対応しています。結果がさらにある場合、レスポンスに nextToken が含まれます。次のページを取得するには、次の呼び出しでその値を渡してください。

開発

git clone https://github.com/vessel-api/vesselapi-mcp.git
cd vesselapi-mcp
npm install
npm run build

npm run build        # Build the server
npm run typecheck    # Type-check without emitting
npm run clean        # Remove build artifacts

MCP Inspector でのテスト

VESSELAPI_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js

データソースと帰属表示

排出量および海難事故データ：© European Union。出典：European Maritime Safety Agency （EMSA）：THETIS-MRV（EU MRV、Regulation (EU) 2015/757）および European Marine Casualty Information Platform（EMCIP）。European Commission の再利用に関する通知 （Commission Decision 2011/833/EU）に基づいて再利用しています。この通知は、出典を明記することを条件に、商用および 非商用目的での再利用を許可しています。データは変換および 統合される場合があります。EMSA は本サービスを推奨するものではありません。

ライセンス

MIT