Vessel Traffic MCP

Vessel Traffic MCP

英語 | 韓国語 | 日本語 | 中国語

AI エージェント向けの船舶追跡と運航スケジュール。

Vessel Traffic MCP は、船舶の識別情報検索、AIS 形式の位置情報、航跡、寄港情報、船会社の運航スケジュール、船舶スケジュール、遅延の推定に対応する読み取り専用の Model Context Protocol（MCP）サーバーです。Claude、ChatGPT、Codex、MCP Inspector、その他の MCP クライアントに、正規化された海事データ用のツール群を提供します。

エージェントが次のことを必要とする場合にご利用ください。

• 汎用コネクター形式の MCP ツールを通じて、船舶情報を検索・取得する。
• 船名、MMSI、IMO、コールサイン、船荷証券のテキストから船舶を特定する。
• 船舶の現在地や過去の航行先、または特定の海域にいる船舶を確認する。
• 港の組み合わせまたは船舶を指定して、コンテナ船の運航スケジュールを検索する。
• ライブデータや公開データの結果すべてに、元のプロバイダーとソース URL を付けて返す。
• 有料の AIS API やスケジュール API を購入する前に、海事関連のワークフローを安全にテストする。

このプロジェクトは、プロバイダーの利用規約、有料コンテンツ、CAPTCHA、アクセス制御を回避しません。商用プロバイダーの利用には、ご自身の API キーをご用意ください。既定のテスト方法はフィクスチャのみであり、航海用製品ではありません。

MIT ライセンスに基づくオープンソースです。バージョン 1.0 以前のため、API やツール群は変更される場合があります。

目次

• MCP クライアントへのインストール
• エージェント向け情報ページ
• 提供機能
• プロバイダーモデル
• 責任ある利用と第三者の権利
• 情報拡散へのご協力
• ソースからの利用
• リモート HTTP のセットアップ
• 現在の配布方法
• スター履歴
• 共通リファレンス

MCP クライアントへのインストール

Claude Desktop、Claude Code、Codex CLI、Cursor、VS Code、または任意の stdio MCP クライアントでは、npm パッケージを使用します。

{
  "mcpServers": {
    "vessel-traffic-mcp": {
      "command": "npx",
      "args": ["-y", "@tools-mcp/vessel-traffic-mcp"],
      "env": {
        "VESSEL_MCP_TRANSPORT": "stdio",
        "VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS": "myshiptracking,tradlinx,aisfriends"
      }
    }
  }
}

次に、クライアントを再起動して、以下をお試しください。

Find the current position of EVER GIVEN. Include source.provider and source.landingUrl.
Search carrier schedules from KRPUS to NLRTM. Include the source URL.

クライアントのセットアップ全般については docs/runbooks/clients.md を、Codex の詳細については docs/runbooks/codex.md をご覧ください。 ソースコードをチェックアウトして使用する場合の設定スニペットは、 共有 MCP 設定スニペットにあります。 マーケットプレイスや AI クライアントへの登録に役立つ資料は、 llms-install.md、LAUNCHGUIDE.md、 および assets/logo-400.png にあります。

エージェント検索ページ

アシスタントエージェントの検索とインストール用スニペットを掲載した公開ランディングページは、次のとおりです。

https://tools-mcp.github.io/vessel-traffic-mcp/

このプロジェクトを 船舶 AIS MCP、船舶追跡 MCP、ChatGPT MCP、 Codex MCP、Claude MCP、または Gemini MCP サーバーとして共有する場合は、この URL をご利用ください。 このページには、EVER GIVEN のシナリオ向けのゴールデンプロンプトと、 ローカル stdio およびリモート Streamable HTTP の設定用スニペットが掲載されています。

アシスタントサービスが、任意の MCP サーバーを自動的に検出することはありません。運用者がまずこの MCP に接続する必要があります。接続後は、ツールの説明、 search／fetch ラッパー、船舶固有のツールによって、船名を含むプロンプトから情報源を明記した結果へと、エージェントが明確な手順でたどり着けます。

提供する機能

分野	読み取り専用ツール
検索形式のコネクターフロー	search、fetch
船舶の識別情報	vessel_search、vessel_name_resolve、document_vessel_lookup
AIS 形式の動静	vessel_position、vessel_area、vessel_track
港湾の活動状況	port_calls
船会社のスケジュール	carrier_schedule_search、vessel_schedule、schedule_delay_predict
プロバイダーの設定	provider_status、data_sources、credential_profiles、provider_onboarding

ライブまたは公開プロバイダーからのすべての応答では、データの出所を明示する必要があります。 source.provider と source.landingUrl がその情報です。このプロジェクトは、 データソースを隠したり自社のものとして見せたりせず、ユーザーを元のサービスに誘導するように設計されています。

プロバイダーモデル

プロバイダーグループ	有効化方法	備考
Fixture	デフォルト	決定論的なテストとデモに使用します。ネットワーク、アカウント、API キーは不要です
公開・オプトイン	VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=myshiptracking,tradlinx,aisfriends	データの出所を明示する公開ウェブアダプターです
BYOK の商用／コミュニティ API	VESSEL_MCP_ENABLE_BYOK_PROVIDERS=... と VESSEL_MCP_PROFILE_* 環境変数	ユーザーが所有する認証情報のみを使用します。ログ、エラー、MCP 応答ではシークレットが秘匿されます
リモートデプロイ	VESSEL_MCP_TRANSPORT=http	/mcp で Streamable HTTP を使用します。Authorization: Bearer <token> を設定するには VESSEL_MCP_AUTH_TOKEN を設定してください

provider_onboarding MCP ツールを使用すると、プロバイダーの登録 URL、必要な環境変数、設定済みプロファイルのステータス、検証手順を確認できます。このツールは読み取り専用であり、アカウントの作成、規約への同意、CAPTCHA の解決、メール認証の完了、支払い情報の設定、API キーの発行は行いません。

責任ある利用と第三者の権利

このプロジェクトは、公共の利益に資する相互運用性、ワークフローのテスト、出典を明示した海事データへのアクセスを目的とするオープンソースのインフラストラクチャとして提供されています。第三者のサービス、データベース、地図、商標、著作物、API のレスポンス、またはプロバイダーのコンテンツをコピー、再配布、ブランド変更、回避、または不正利用する権利を付与するものではありません。

ソフトウェアの設定と運用方法については、適用法、プロバイダーの利用規約、アカウント権限、レート制限、データライセンス、および社内ポリシーの遵守を含め、ユーザーが責任を負います。このプロジェクトを認証、ペイウォール、CAPTCHA、アクセス制御、robots ポリシー、または商業上の制限の回避に使用しないでください。

作者およびコントリビューターは、参照されているすべてのサービスとデータプロバイダーの権利および利用規約を尊重します。ライブデータおよび公開プロバイダーのレスポンスでは、source.provider と source.landingUrl を通じて出典を維持し、ユーザーを元の情報源に誘導するように設計されています。権利者、サービス運営者、または影響を受ける当事者から根拠のある懸念が報告された場合、メンテナーは速やかに確認し、必要に応じて該当するアダプター、ドキュメント、フィクスチャ、または参照情報を変更、無効化、もしくは削除します。

このソフトウェアは MIT ライセンスのもと、無保証で提供されます。この README の内容は法的助言ではなく、お客様自身のユースケースに適用される利用規約を確認する代わりになるものでもありません。

拡散へのご協力

このプロジェクトが、MCP ツール、輸送・物流ソフトウェア、または海事データを活用する AI ワークフローの開発者に役立ちそうであれば、リポジトリを共有し、実際のワークフローに関するフィードバックをお寄せください。コピーしてすぐに使える共有用キットは、docs/marketing/help-us-spread.md にあります。

ご協力いただけることとして、npm インストールを試す、対象に合わせたコミュニティ向けの紹介記事を投稿する、プロバイダーアダプターをリクエストする、または実際のフォワーディング、貿易、入港、船舶の ETA、運航会社のスケジュールに関するワークフローを説明するといったものがあります。

ソースからの実行

git clone https://github.com/tools-mcp/vessel-traffic-mcp.git
cd vessel-traffic-mcp
npm ci
npm run lint
npm test
npm run build
VESSEL_MCP_TRANSPORT=stdio \
VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=myshiptracking,tradlinx,aisfriends \
npm start

デフォルトの検証ゲートでは、サニタイズ済みのフィクスチャのみを使用します。有料またはライブのプロバイダーには接続せず、API キー、アカウント、ネットワークアクセスも必要ありません。

船名の入力と地図を使ってローカルで表示を確認するには、次のようにします。

npm run start:map

http://127.0.0.1:8787 を開き、EVER GIVEN または MMSI 353136000 を検索します。

リモート HTTP のセットアップ

リモート MCP クライアントの場合は、公開エンドポイント /health を備えた Streamable HTTP を /mcp で実行します。

export VESSEL_MCP_TRANSPORT=http
export VESSEL_MCP_HTTP_HOST=127.0.0.1
export VESSEL_MCP_HTTP_PORT=8765
export VESSEL_MCP_AUTH_TOKEN="<a-strong-random-token-you-generated>"
npm run start:http

curl -sf "http://127.0.0.1:8765/health"

VESSEL_MCP_AUTH_TOKEN が設定されている場合、MCP リクエストには Authorization: Bearer <token> が必要です。詳細は docs/runbooks/streamable-http-server.md および docs/runbooks/deployment-https.md を参照してください。

現在の配布状況

提供先	状況	アクセス
GitHub	公開	https://github.com/tools-mcp/vessel-traffic-mcp
エージェント向けランディングページ	公開	https://tools-mcp.github.io/vessel-traffic-mcp/
npm	公開	@tools-mcp/[email protected]（https://www.npmjs.com/package/@tools-mcp/vessel-traffic-mcp）
GitHub Release	公開済み	https://github.com/tools-mcp/vessel-traffic-mcp/releases/tag/v0.1.0
MCP Registry	登録済み	公式レジストリの io.github.tools-mcp/[email protected]
ServerHub	掲載済み	https://www.serverhub.digital/servers/vessel-traffic-mcp
VaultPlane	掲載済み	https://www.vaultplane.com/server/vessel-traffic-mcp
MCPRepository	申請済み	https://mcprepository.com/tools-mcp/vessel-traffic-mcp で検証待ち
ローカルマップ UI	ソースから起動可能	npm run start:map を実行し、http://127.0.0.1:8787 を開きます
HTTP ディレクトリメタデータ	ソースから利用可能	npm run start:http を実行し、/.well-known/mcp/server-card.json を取得します
Glama	審査を申請済み	2026-05-27 に Glama の Add Server フローから申請済みです。公開リスティング URL とスコアバッジは https://glama.ai/mcp/servers/tools-mcp/vessel-traffic-mcp に確保されています。審査／インデックス作成が完了するまでは 404 が返される場合があります
PulseMCP	申請／インデックス作成待ち	docs/runbooks/public-sharing.md と docs/marketing/outreach-status.md で追跡します
Smithery	HTTPS エンドポイント待ち	安定した公開 HTTPS /mcp URL が必要です

ローンチ用の紹介文とディレクトリ申請用の資料は docs/marketing にあります。

スター履歴

言語

• English
• 한국어
• 日本語
• 中文

エージェント向けプロンプト

別のコーディングエージェントに MCP のインストールを依頼するときは、このプロンプトを使用してください。

Install and configure https://github.com/tools-mcp/vessel-traffic-mcp
as a local stdio MCP server on this machine.

Read README.md and llms.txt first. Clone the repository, run `npm ci`,
run `npm run build`, then add the MCP server to the local MCP client
using an absolute path to `dist/index.js`.

Use `VESSEL_MCP_TRANSPORT=stdio` and enable public providers with
`VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=myshiptracking,tradlinx,aisfriends`.

Do not commit local MCP client config files, env files, API keys,
cookies, HAR files, browser sessions, or raw captures. Do not copy
credentials from another machine.

After restarting the MCP client, verify with:
1. Ask for EVER GIVEN current position and include the source URL.
2. Ask for a KRPUS to NLRTM carrier schedule and include the source URL.

한국어

개요

vessel-traffic-mcp는 MCP 클라이언트가 허가된 해운/선박 데이터 소스를 읽기 전용 도구로 조회할 수 있게 해주는 서버입니다.

선박명, MMSI, IMO, 호출부호 기반 검색, 최신 위치 조회, 영역 조회, 항만 호출, 선사 스케줄, 선박별 스케줄, 스케줄 지연 판단을 제공합니다.

실시간 또는 공개 provider 응답은 반드시 source.provider와 source.landingUrl을 포함해야 합니다. 이 프로젝트의 목적은 원 서비스 유입과 출처 노출을 제공하는 것이며, 출처를 숨기거나 재브랜딩하는 것이 아닙니다.

공유를 도와줄 사람에게 보낼 짧은 문구와 커뮤니티용 글 초안은 docs/marketing/help-us-spread.md에 정리되어 있습니다.

빠른 시작

git clone https://github.com/tools-mcp/vessel-traffic-mcp.git
cd vessel-traffic-mcp
npm install
npm run lint
npm test
npm run build

기본 검증은 sanitize된 fixture만 사용합니다. 유료 provider나 live provider를 호출하지 않으며 API 키, 계정, 네트워크 접근이 필요하지 않습니다.

로컬 MCP 설정

로컬 데스크톱/CLI 클라이언트에서는 stdio transport를 사용합니다.

VESSEL_MCP_TRANSPORT=stdio npm start

Codex CLI, Claude Desktop, Claude Code 설정은 공통 MCP 설정 예시를 사용하면 됩니다. 전체 클라이언트 설정은 docs/runbooks/clients.md, Codex 전용 설정은 docs/runbooks/codex.md에 정리되어 있습니다.

원격 MCP 설정

원격 MCP 클라이언트는 Streamable HTTP /mcp 엔드포인트를 사용합니다. /health는 공개 health check입니다.

export VESSEL_MCP_TRANSPORT=http
export VESSEL_MCP_HTTP_HOST=127.0.0.1
export VESSEL_MCP_HTTP_PORT=8765
export VESSEL_MCP_AUTH_TOKEN="<a-strong-random-token-you-generated>"
npm run start:http

VESSEL_MCP_AUTH_TOKEN을 설정한 경우 MCP 요청에는 Authorization: Bearer <token>이 필요합니다. 배포 문서는 docs/runbooks/deployment-https.md를 참고하세요.

공개 Provider

브라우저 캡처 기반 공개 adapter는 명시적으로 켜야 합니다.

VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=myshiptracking,tradlinx,aisfriends npm start

• myshiptracking: 선박 자동완성, 선택 MMSI 기반 최신 위치, 지도 영역 조회.
• tradlinx: FCL/LCL 선사 스케줄 조회.
• aisfriends: 공개 지도 bounding-box 기반 영역 위치 조회. 선박명 검색은 지원하지 않습니다.
• shipfinder: 명시적 provider 라우팅용 선박 자동완성 및 상세 API 형태.

응답에는 항상 원 출처 provider와 사용자가 열 수 있는 출처 URL을 포함합니다.

BYOK Provider

유료/credential 기반 provider는 BYOK 방식으로만 사용합니다. 실제 키는 로그, 에러, MCP 응답에 노출되지 않습니다.

export VESSEL_MCP_PROFILE_MARINETRAFFIC__API_KEY="<your-key>"
export VESSEL_MCP_ENABLE_BYOK_PROVIDERS="marinetraffic,vesselfinder,aisstream,aishub,barentswatch,searates-schedules,routescanner-connect,vesselapi,datadocked,datalastic,globalfishingwatch"

현재 credential 기반으로 런타임 등록 가능한 provider는 marinetraffic, vesselfinder, aisstream, aishub, barentswatch, searates-schedules, routescanner-connect, vesselapi, datadocked, datalastic, globalfishingwatch입니다. 기본 credential profile이 설정된 provider는 자동으로 등록됩니다.

자세한 내용은 docs/runbooks/credential-profiles.md와 docs/runbooks/operator.md를 참고하세요.

provider_onboarding MCP 도구를 사용하면 provider별 가입 URL, 필요한 env var, 현재 credential 설정 여부, 검증 단계를 확인할 수 있습니다. 이 도구는 읽기 전용이며 계정 생성, 약관 동의, CAPTCHA, 이메일 인증, 결제 정보 설정, API 키 발급을 대신 수행하지 않습니다.

책임 있는 사용 및 제3자 권리

이 프로젝트는 공익적 상호운용성, 업무 자동화 실험, 출처가 표시되는 해운/선박 데이터 접근을 돕기 위해 오픈소스로 공개되었습니다. 이 프로젝트는 제3자 서비스, 데이터베이스, 지도, 상표, 저작물, API 응답, provider 콘텐츠를 복제, 재배포, 재브랜딩, 우회, 오용할 권리를 부여하지 않습니다.

소프트웨어를 어떻게 설정하고 사용하는지는 사용자 책임입니다. 사용자는 관련 법령, provider 약관, 계정 권한, rate limit, 데이터 라이선스, 내부 회사 정책을 직접 확인하고 준수해야 합니다. 인증, 유료 기능, CAPTCHA, 접근 제어, robots 정책, 상업적 제한을 우회하기 위해 이 프로젝트를 사용해서는 안 됩니다.

작성자와 기여자는 참조된 모든 서비스와 데이터 provider의 권리와 약관을 존중합니다. live/public provider 응답은 source.provider와 source.landingUrl로 원 출처를 표시하고, 사용자가 원 서비스를 확인할 수 있도록 설계되었습니다. 권리자, 서비스 운영자, 또는 관련 당사자가 근거 있는 문제를 제기하면 maintainer는 신속히 검토하고, 필요한 경우 해당 adapter, 문서, fixture, reference를 수정, 비활성화, 또는 제거하겠습니다.

이 소프트웨어는 MIT 라이선스에 따라 보증 없이 제공됩니다. 이 README의 문구는 법률 자문이 아니며, 각 사용 사례에 적용되는 약관과 법적 의무를 검토하는 일을 대체하지 않습니다.

에이전트 설정 프롬프트

다른 코딩 에이전트에게 이 MCP를 설치하게 할 때 사용할 프롬프트입니다.

https://github.com/tools-mcp/vessel-traffic-mcp 를 이 머신의 로컬
stdio MCP 서버로 설치하고 설정해줘.

먼저 README.md와 llms.txt를 읽어라. repo를 clone하고 `npm ci`,
`npm run build`를 실행한 뒤, 로컬 MCP 클라이언트 설정에
`dist/index.js`의 절대경로를 등록해라.

`VESSEL_MCP_TRANSPORT=stdio`를 사용하고,
`VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=myshiptracking,tradlinx,aisfriends`를 설정해라.

로컬 MCP 클라이언트 설정 파일, env 파일, API 키, 쿠키, HAR 파일,
브라우저 세션, raw capture는 커밋하지 마라. 다른 머신의 credential을
복사하지 마라.

MCP 클라이언트를 재시작한 뒤 다음으로 검증해라:
1. EVER GIVEN 현재 위치를 조회하고 출처 URL을 함께 보여줘.
2. KRPUS에서 NLRTM까지의 선사 스케줄을 조회하고 출처 URL을 함께 보여줘.

日本語

概要

vessel-traffic-mcp は、MCP クライアントから許可された海事データ ソースを読み取り専用で参照するためのサーバーです。

船名、MMSI、IMO、コールサインによる検索、最新位置、エリア検索、 寄港情報、船会社スケジュール、船舶別スケジュール、遅延判定を 提供します。

ライブまたは公開 provider の応答では、source.provider と source.landingUrl を必ず含めます。このプロジェクトは元サービスへ ユーザーを誘導し、出典を明示することを目的としています。

クイックスタート

git clone https://github.com/tools-mcp/vessel-traffic-mcp.git
cd vessel-traffic-mcp
npm install
npm run lint
npm test
npm run build

標準の検証は sanitize 済み fixture のみを使います。有料 provider や live provider は呼び出さず、API キー、アカウント、ネットワーク接続も 不要です。

ローカル MCP 設定

ローカルのデスクトップ/CLI クライアントでは stdio transport を使います。

VESSEL_MCP_TRANSPORT=stdio npm start

Codex CLI、Claude Desktop、Claude Code の設定には 共通 MCP 設定例を使用してください。

リモート MCP 設定

リモート MCP クライアントでは Streamable HTTP の /mcp を使います。 /health は公開 health check です。

export VESSEL_MCP_TRANSPORT=http
export VESSEL_MCP_HTTP_HOST=127.0.0.1
export VESSEL_MCP_HTTP_PORT=8765
export VESSEL_MCP_AUTH_TOKEN="<a-strong-random-token-you-generated>"
npm run start:http

VESSEL_MCP_AUTH_TOKEN を設定した場合、MCP リクエストには Authorization: Bearer <token> が必要です。

公開 Provider

ブラウザキャプチャ由来の公開 adapter は明示的に有効化します。

VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=myshiptracking,tradlinx,aisfriends npm start

• myshiptracking: 船舶オートコンプリート、選択 MMSI からの最新位置、 地図範囲検索。
• tradlinx: FCL/LCL の船会社スケジュール検索。
• aisfriends: 公開地図の bounding-box ベースのエリア位置検索。船名検索は未対応。
• shipfinder: 明示的 provider ルーティング用の船舶検索と詳細 API 形状。

BYOK Provider

有料または credential が必要な provider は BYOK のみです。実際のキーは ログ、エラー、MCP 応答に出しません。

export VESSEL_MCP_PROFILE_MARINETRAFFIC__API_KEY="<your-key>"
export VESSEL_MCP_ENABLE_BYOK_PROVIDERS="marinetraffic,vesselfinder,aisstream,aishub,barentswatch,searates-schedules,routescanner-connect,vesselapi,datadocked,datalastic,globalfishingwatch"

現在 runtime で有効化できる credentialed provider は marinetraffic, vesselfinder, aisstream, aishub, barentswatch, searates-schedules, routescanner-connect, vesselapi, datadocked, datalastic, globalfishingwatch です。

エージェント設定プロンプト

別のコーディングエージェントに MCP を設定させる場合のプロンプトです。

https://github.com/tools-mcp/vessel-traffic-mcp を、このマシンの
ローカル stdio MCP サーバーとしてインストールして設定してください。

最初に README.md と llms.txt を読んでください。repo を clone し、
`npm ci` と `npm run build` を実行し、`dist/index.js` の絶対パスを
ローカル MCP クライアントに登録してください。

`VESSEL_MCP_TRANSPORT=stdio` を使い、
`VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=myshiptracking,tradlinx,aisfriends` を設定してください。

ローカル MCP クライアント設定、env ファイル、API キー、Cookie、HAR、
ブラウザセッション、raw capture を commit しないでください。他の
マシンから credential をコピーしないでください。

再起動後、EVER GIVEN の現在位置と出典 URL、KRPUS から NLRTM への
船会社スケジュールと出典 URL を確認してください。

中文

概览

vessel-traffic-mcp 是一个只读 MCP 服务器，让 MCP 客户端能够通过 统一工具接口访问已授权的海事数据来源。

它支持按船名、MMSI、IMO、呼号搜索船舶，查询最新位置、区域位置、 港口靠泊、承运人航线计划、船舶计划和延误判断。

所有实时或公开 provider 的响应都必须包含 source.provider 和 source.landingUrl。本项目用于向原始服务导流并明确显示出处，而不是 隐藏或重新包装数据来源。

快速开始

git clone https://github.com/tools-mcp/vessel-traffic-mcp.git
cd vessel-traffic-mcp
npm install
npm run lint
npm test
npm run build

默认验证只使用已清洗的 fixture，不调用付费或实时 provider，也不需要 API key、账号或网络访问。

本地 MCP 设置

本地桌面和 CLI 客户端使用 stdio transport。

VESSEL_MCP_TRANSPORT=stdio npm start

Codex CLI、Claude Desktop、Claude Code 可使用 共享 MCP 配置片段。

远程 MCP 设置

远程 MCP 客户端使用 Streamable HTTP /mcp，/health 是公开健康检查。

export VESSEL_MCP_TRANSPORT=http
export VESSEL_MCP_HTTP_HOST=127.0.0.1
export VESSEL_MCP_HTTP_PORT=8765
export VESSEL_MCP_AUTH_TOKEN="<a-strong-random-token-you-generated>"
npm run start:http

设置 VESSEL_MCP_AUTH_TOKEN 后，MCP 请求需要 Authorization: Bearer <token>。

公开 Provider

浏览器捕获得到的公开 adapter 需要显式启用。

VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=myshiptracking,tradlinx,aisfriends npm start

• myshiptracking: 船舶自动完成、按选定 MMSI 查询最新位置、地图范围查询。
• tradlinx: FCL/LCL 承运人航线计划查询。
• aisfriends: 基于公开地图 bounding-box 的区域位置查询；不支持船名搜索。
• shipfinder: 用于显式 provider 路由的船舶搜索和详情 API 形状。

BYOK プロバイダー

有料または認証情報が必要なプロバイダーは、BYOK でのみ使用できます。実際のキーがログ、 エラー、または MCP レスポンスに表示されることはありません。

export VESSEL_MCP_PROFILE_MARINETRAFFIC__API_KEY="<your-key>"
export VESSEL_MCP_ENABLE_BYOK_PROVIDERS="marinetraffic,vesselfinder,aisstream,aishub,barentswatch,searates-schedules,routescanner-connect,vesselapi,datadocked,datalastic,globalfishingwatch"

現在、ランタイムで有効化できる認証情報が必要なプロバイダーは marinetraffic, vesselfinder, aisstream, aishub, barentswatch, searates-schedules, routescanner-connect, vesselapi, datadocked, datalastic, globalfishingwatch です。

エージェント設定用プロンプト

別のコーディングエージェントにこの MCP をインストールさせる際に、以下のプロンプトを使用できます。

请将 https://github.com/tools-mcp/vessel-traffic-mcp 安装并配置为本机
本地 stdio MCP 服务器。

先阅读 README.md 和 llms.txt。clone 仓库，运行 `npm ci` 和
`npm run build`，然后在本地 MCP 客户端中用 `dist/index.js` 的绝对路径
注册服务器。

使用 `VESSEL_MCP_TRANSPORT=stdio`，并设置
`VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS=myshiptracking,tradlinx,aisfriends`。

不要提交本地 MCP 客户端配置、env 文件、API key、cookie、HAR 文件、
浏览器 session 或 raw capture。不要从其他机器复制 credentials。

重启 MCP 客户端后验证：
1. 查询 EVER GIVEN 当前船位，并显示来源 URL。
2. 查询 KRPUS 到 NLRTM 的承运人航线计划，并显示来源 URL。

共通リファレンス

共通 MCP 設定スニペット

Codex CLI ~/.codex/config.toml：

[mcp_servers.vessel-traffic-mcp]
command = "node"
args = ["/absolute/path/to/vessel-traffic-mcp/dist/index.js"]

[mcp_servers.vessel-traffic-mcp.env]
VESSEL_MCP_TRANSPORT = "stdio"
VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS = "myshiptracking,tradlinx,aisfriends"

Claude Desktop / Claude Code の設定：

{
  "mcpServers": {
    "vessel-traffic-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/vessel-traffic-mcp/dist/index.js"],
      "env": {
        "VESSEL_MCP_TRANSPORT": "stdio",
        "VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS": "myshiptracking,tradlinx,aisfriends"
      }
    }
  }
}

プロバイダー実装状況

PRD は、デフォルトで有効になっているアダプターの範囲より意図的に広く設定されています。 現在の状況：

グループ	ランタイムの状況	プロバイダー
デフォルト	環境変数なしで有効	fixture
オプトインの公開プロバイダー	VESSEL_MCP_ENABLE_PUBLIC_PROVIDERS	aisfriends, myshiptracking, shipfinder, tradlinx-schedule
実装済みの認証情報が必要なプロバイダー	VESSEL_MCP_ENABLE_BYOK_PROVIDERS または設定済みのデフォルトプロファイル	marinetraffic, vesselfinder, aisstream, aishub, barentswatch, searates-schedules, routescanner-connect, vesselapi, datadocked, datalastic, globalfishingwatch
実装予定のスケジュール API	カタログに登録済み、未実装	linescape-schedule-api
未着手の商用 AIS	カタログに登録済み、未実装	spire-maritime, orbcomm-commtrace
調査またはエンタープライズ向けレビュー	カタログのみ	openais, noaa-marinecadastre, iqax-bigschedules, cargosmart-schedule, poseidon-ais, ais-now, fleetmon, windward, polestar-global, spglobal-seaweb, lloyds-list-intelligence

構造化された信頼できる情報源は config/provider-catalog.example.json で、人が読める一覧は docs/provider-catalog.md にあります。

ローカル船舶マップ UI

船名を入力して地図を表示し、ローカルで視覚的に確認するには：

npm run start:map

http://127.0.0.1:8787 を開き、EVER GIVEN または MMSI 353136000 を検索します。UI には地図マーカーと、表示されたソースへのリンクが表示されます。

スケジュールツール

登録済みの読み取り専用スケジュールツール：

• carrier_schedule_search
• vessel_schedule
• schedule_delay_predict

登録済みの読み取り専用プロバイダー／セットアップツール：

• provider_status
• data_sources
• credential_profiles
• provider_onboarding

フィクスチャを利用した確認：

KRPUS에서 NLRTM으로 가는 선사 스케줄을 조회하고, 출처 URL도 같이 보여줘.
EVER GIVEN 선박 스케줄을 조회하고 ETA 지연 여부를 계산해줘.

スケジュールプロバイダーの候補は docs/provider-catalog.md で管理されています。Tradelinx には、 docs/runbooks/schedule-api-capture-results.md に記載された、ブラウザーで取得したエンドポイント形式をサニタイズして利用する 明示的なオプトイン方式の carrier_schedule_search アダプターがあります。

キャプチャと安全性の境界

このプロジェクトは商用サービスの回避を目的としていません。次のものをサポートします。

• 公式 API とオープンデータフィード。
• 有料プロバイダー向けにユーザーが提供する API 認証情報と、組織レベルの BYOK 認証情報プロファイル。
• サービス利用規約で許可されている場合に限り、運用者が所有し、使用を許可されたブラウザーセッションから取得したサニタイズ済みの HAR／ネットワークサンプル。

リポジトリに生の Cookie、ベアラートークン、API キー、非公開の HAR ファイル、 生のキャプチャデータ、非公開のブラウザーセッションを保存してはなりません。 すべての厳守ルールは AGENTS.md に記載されており、 セキュリティ要件については SECURITY.md を参照してください。

許可されたキャプチャツールの説明は docs/runbooks/capture-execution.md にあります。 サニタイズ済みデータのインポートコマンドは npm run capture:import、 トラフィック IR の生成コマンドは npm run capture:ir です。

ナビゲーション用途ではありません。設定されたプロバイダーから返される AIS データは、 遅延、不完全、または不正確な場合があります。このプロジェクトは 安全性が重要となるナビゲーションツールではありません。

プロジェクトの構成

src/
  capture/      sanitized capture fixture importer + traffic IR CLI
  config/       credential profile loader, provider catalog
  providers/    adapter interfaces, registry, router, rate limit, TTL cache
  server/       MCP transports and tool handlers
  tools/        read-only tool definitions
  util/         structured logging and redaction helpers
test/           node:test deterministic tests; fixture-backed
docs/           PRD, TDD, provider catalog, and runbooks

ドキュメント

• llms.txt — エージェント向けの簡潔なプロジェクト概要です。
• docs/index.html — GitHub Pages で公開されている静的なエージェント検出ページです。
• server.json — io.github.tools-mcp/vessel-traffic-mcp 名前空間の MCP Registry メタデータです。
• AGENTS.md — プロジェクトの厳守事項です。
• CODE_OF_CONDUCT.md — コラボレーションに関する期待事項です。
• docs/PRD.md — プロダクト要件です。
• docs/TDD.md — 技術設計です。
• docs/provider-catalog.md — プロバイダーの一覧とルーティングポリシーです。
• docs/runbooks/operator.md — オペレーター向けのエンドツーエンドの運用手順書です。
• docs/runbooks/clients.md — Claude Desktop、Claude Code、ChatGPT リモート MCP、MCP Inspector のクライアント設定です。
• docs/runbooks/codex.md — Codex CLI の MCP 接続設定と Codex プラグインのメタデータ状態です。
• docs/runbooks/credential-profiles.md — BYOK プロファイルの取り扱いです。
• docs/runbooks/deployment-https.md — Streamable HTTP MCP エンドポイントの HTTPS デプロイです。
• docs/runbooks/release-checklist.md — リリース前の安全チェックリストです。
• docs/runbooks/public-sharing.md — GitHub、MCP Registry、Smithery、Glama、PulseMCP、ローンチ投稿での共有チェックリストです。
• docs/runbooks/api-capture-reference-only.md — 生のキャプチャセッションの参照専用の境界についてです。
• docs/runbooks/browser-api-capture-results.md — 船舶 API のサニタイズ済みブラウザーキャプチャ結果です。
• docs/runbooks/schedule-api-capture-results.md — スケジュール API のサニタイズ済みブラウザーキャプチャ結果です。
• docs/discoverability.md — パッケージ、リポジトリ、ドキュメントの発見可能性に関する契約です。

トピック

vessel-traffic-mcp は、MCP やプラグインの検索先から見つけられることを想定しています。同じトピック一覧を package.json のキーワードと GitHub の推奨トピックにも反映しています。

• 船舶 AIS MCP
• 船舶追跡 MCP
• MarineTraffic MCP
• Claude MCP（Claude Desktop、Claude Code）
• ChatGPT MCP（ChatGPT リモート MCP コネクター）
• Codex プラグイン（Codex／OpenAI プラグイン／マーケットプレイスのワークフロー）
• Gemini MCP（Gemini CLI と Gemini Code Assist）
• MCP／Model Context Protocol サーバー
• AIS／船舶追跡
• BYOK による有料プロバイダーのルーティング（MarineTraffic、VesselFinder、AISStream、 AISHub、BarentsWatch、SeaRates、Routescanner、VesselAPI、Data Docked、 およびその他のカタログ項目）

コントリビューション

コントリビューションを歓迎します。まず CONTRIBUTING.md をお読みください。このプロジェクトには、認証情報、キャプチャ用フィクスチャ、読み取り専用の契約に関する、妥協できない安全規則があります。

バグ、プロバイダーのリクエスト、許可済みキャプチャのレビューには、GitHub Issues をご利用ください。ロードマップ、統合、コラボレーションに関する議論には、GitHub Discussions をご利用ください。共有チェックリストは docs/runbooks/public-sharing.md にあります。

セキュリティ

脆弱性が疑われる場合は、公開の GitHub Issue を作成しないでください。非公開の報告窓口については SECURITY.md をご覧ください。

ライセンス

MIT。航行用途ではない旨の通知については、NOTICE をご覧ください。