arcnautical

@arcnautical/mcp

ArcNautical API 用の MCP サーバーです。Claude、ChatGPT、Cursor、VS Code、Windsurf、その他の MCP クライアントから、IMO 番号を使って商船の制裁対象状況、所有者の不透明性、審査グレードを確認できます。

API キーなしで使えるツールが 2 つあります。 追加して「IMO 9274446 は制裁対象ですか？」と尋ねるだけで、答えが得られます。

使い方は 2 通りあります。https://mcp.arcnautical.com/mcp のリモートエンドポイント（インストール不要。claude.ai、ChatGPT、Claude Code、Cursor）か、npx -y @arcnautical/mcp を使う stdio 経由のローカルサーバー（Claude Desktop およびその他すべての stdio クライアント）です。

IMO 9274446 HS STAR: sanctions RED — 4 confirmed matches on vessel identifier.
Ownership opacity MEDIUM. Vetting grade E (unacceptable). Checked 2026-09-12T08:10:40Z.

リモートエンドポイント（インストール不要）

https://mcp.arcnautical.com/mcp — MCP Streamable HTTP、ステートレス、JSON レスポンスです。check_vessel と find_port に認証は不要です。API キーが必要なツールでは、MCP リクエストの Authorization: Bearer ヘッダーに API キーを指定してください（ヘッダー名を独自に設定するゲートウェイ向けに、X-API-Key または arcnautical-api-key ヘッダーも使用できます。クエリパラメーターは使用しないでください）。

claude.ai — Settings → Connectors → Add custom connector → URL に https://mcp.arcnautical.com/mcp を指定します。認証は不要です。キー不要の 2 つのツールをすぐに使えます。

ChatGPT — Settings → Connectors → Create（developer mode）→ server URL に https://mcp.arcnautical.com/mcp を指定します。認証は不要です。

Claude Code

claude mcp add --transport http arcnautical https://mcp.arcnautical.com/mcp
claude mcp add --transport http arcnautical https://mcp.arcnautical.com/mcp --header "Authorization: Bearer arc_live_…"

Cursor — .cursor/mcp.json：

{
  "mcpServers": {
    "arcnautical": {
      "url": "https://mcp.arcnautical.com/mcp",
      "headers": { "Authorization": "Bearer arc_live_…" }
    }
  }
}

curl を使う場合 — エンドポイントは POST 経由のプレーンな JSON-RPC です。

curl -s https://mcp.arcnautical.com/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_vessel","arguments":{"imo":"9274446"}}}'

リモートエンドポイントは、同じ公開 API の薄いクライアントです。キー不要の呼び出しはお客様の 1 時間あたり 100 回の上限にカウントされます（呼び出し元のアドレスが転送されます）。キーを使った呼び出しは、API を直接呼び出した場合と同様に、お客様のキーで使用量が計測されます。GET /mcp は 405 を返します。保持するサーバーからクライアントへのストリームはありません。GET https://mcp.arcnautical.com/health では、エンドポイントのバージョンを確認できます。

ローカルサーバー（stdio）

Node 18 以降が必要です。インストールは不要です。以下の各クライアントは npx で起動します。

Claude Desktop — claude_desktop_config.json：

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

Claude Code

claude mcp add arcnautical -- npx -y @arcnautical/mcp

Cursor / Windsurf / VS Code — クライアントの MCP 設定で、同じ command / args 形式を使用します。

完全な記録、バッチ処理、航海スコアリングを利用するには、env ブロックに API キーを追加します。

{
  "mcpServers": {
    "arcnautical": {
      "command": "npx",
      "args": ["-y", "@arcnautical/mcp"],
      "env": { "ARCNAUTICAL_API_KEY": "arc_live_…" }
    }
  }
}

キーは https://arcnautical.com/get-a-key?from=mcp から無料でセルフサービスで取得できます。クレジットカードも承認手続きも不要です。新しいキーには、船舶スクリーニングの初回無料利用枠と、航海評価の月間利用枠が含まれます。get_usage で両方を確認でき、最新の数値は arcnautical.com/developers で確認できます。

ツール

ツール	キー	説明
check_vessel	不要	1 隻の IMO について、制裁対象状況（OFAC SDN、EU、UN、UK OFSI、OpenSanctions）、所有者の不透明性スコア、A～E の審査グレードを確認します。IP ごとに 1 時間あたり 100 回まで。
find_port	不要	港名または国名から UN/LOCODE を検索します。score_voyage の前に呼び出してください。
screen_vessel	必要	完全なスクリーニング記録を返します。各一致のソースリスト、プログラム、信頼度クラス、評価済みの審査要素、ソースごとの最新性、保持される記録 ID が含まれます。同じ船体を同日に再度確認した場合は、無料で結果を再表示します。
screen_vessels	必要	最大 50 件の IMO を一括処理し、結果を返します。
get_screening	必要	保存された記録を ID で取得します（10 年間保持）。
score_voyage	必要	2 つの LOCODE 間の航路リスクを、スコア、レベル、要因、信頼度、不足しているソースとともに返します。
get_usage	必要	設定済みキーの残りの利用枠と上限を確認します。

判定結果の読み方

• RED — 船舶識別子の一致が確認されています。AMBER — 一致の可能性があるため、確認してください。GREEN — 到達できた情報源との照合では一致しません。INCOMPLETE — 主要な情報源を読み取れませんでした。問題なしとして提示しないでください。
• GREEN で coverage_complete: false の場合は、補足リストを1つ利用できなかったことを意味します。これを頼りにする前に再スクリーニングしてください。
• assessed: false は、所有権と審査が調査結果ではなく、デフォルト値であることを意味します。
• キー不要のチェックでは、船舶の現在の名称と識別子のみを照合します。指定後に船名が変更された船舶は、そこで GREEN と判定される場合があります。このケースは screen_vessel で確認できます。
• 指定情報は毎日変わります。回答には checkedAt ／ screened_at の時刻を記載してください。

冪等性

リソースを作成する各呼び出しでは、試行ごとではなく、質問（船体と UTC の日付）をもとに Idempotency-Key を生成します。同じ船舶について同じ日に2回問い合わせても、保存済みの記録が返され、費用はかかりません。API のドキュメントによると、あるインテグレーションでは月間スクリーニングの42％が同日中の再試行で、クライアントが呼び出しごとにランダムなキーを生成していたためにのみ課金されていました。このサーバーではそのようなことはありません。

環境

変数	デフォルト	用途
ARCNAUTICAL_API_KEY	未設定	キーが必要なツールを有効にします（stdio の場合。リモートエンドポイントでは代わりに Authorization ヘッダーを読み取ります）。
ARCNAUTICAL_BASE_URL	https://arcnautical.com	テスト用の上書き値です。
PORT / HOST	3005 / すべてのインターフェース	--http のみ。
MCP_TRUST_PROXY	未設定	--http のみ：1 を設定すると、リバースプロキシが設定した X-Real-IP ／ CF-Connecting-IP から呼び出し元のアドレスを読み取ります。ポートに到達できるのがプロキシだけの場合に限ります。

HTTP エンドポイントのセルフホスト

npx -y @arcnautical/mcp --http を実行すると、ポート3005で POST /mcp を提供します。アシスタントを実行するネットワークからローカルプロセスを起動できないものの、内部 URL にはアクセスできる場合に便利です。このリポジトリの Dockerfile は同じものをビルドします。mcp.arcnautical.com もこれを実行しています。

リンク

• ガイド：https://arcnautical.com/developers/
• リファレンス：https://arcnautical.com/developers/reference/
• OpenAPI 3.1：https://arcnautical.com/api/v1/openapi.json
• Postman：https://www.postman.com/arcnautical-6322764/arcnautical-s-workspace
• エージェント向け：https://arcnautical.com/llms.txt
• 掲載先：MCP レジストリ（com.arcnautical/mcp） · Smithery · npm · Wellknown（所有者確認済み。到達可能性を随時チェック）

開発

npm install
npm test        # builds, then drives dist/cli.js over stdio AND createHttpServer() over Streamable HTTP
                # (a local stub API asserts the forwarded caller address and Bearer key; one call hits prod keyless)
npm run start:http   # the remote endpoint on http://localhost:3005/mcp

MIT © ArcNautical