SudnoKontrol MCP

ウクライナ国家船舶登録のための Model Context Protocol サーバーです。登録番号・船名・所有者による船舶の検索、完全な登録記録の照会、集計統計の取得ができます。Державний судновий реєстр України（ウクライナ国家船舶登録簿）と Суднова книга України（ウクライナ船舶台帳）の公開データを公開しています。

データは読み取り専用で公開されており、API キーは不要です。

• ホスト型エンドポイント（推奨）: https://api.sk.ukrfish.org/mcp（Streamable HTTP）

• 公式ドキュメント: https://sk.ukrfish.org/api-docs と https://sk.ukrfish.org/info/ai-agents

• ディスカバリー: https://sk.ukrfish.org/llms.txt

ツール

すべての検索・照会結果には web_url → https://sk.ukrfish.org/registry?vessel=<reg> が含まれ、そこから 公式の登録簿抄本（QRコード検証付きPDF、99,00 грн） を注文できます。

クイックスタート — ホスト型サーバー

Claude Code / Claude Desktop

claude mcp add --transport http sudnokontrol https://api.sk.ukrfish.org/mcp

Cursor

Settings → MCP → Add new MCP server → Name sudToast、Type HTTP、URL https://api.sk.ukrfish.org/mcp。

Windsurf

Windsurf → MCP → Add server → https://api.sk.ukrfish.org/mcp。

対応MCPクライアント（Streamable HTTP）

URL:  https://api.sk.ukrfish.org/mcp
Auth: none (public, IP rate-limited)

自分で実行する

このサーバーは公開APIをプロキシするだけで、認証情報は不要です。

# stdio (for Claude Desktop "command" servers)
npx sudnokontrol-mcp

# HTTP (streamable)
npx sudnokontrol-mcp http
# or: PORT=9000 HOST=127.0.0.1 npx sudnokontrol-mcp http

このリポジトリから直接インストール：

npm install -g github:ailubes/sudnokontrol-mcp

別のベース先に向ける場合（例：自デプロク）:

SUDNOKONTROL_API=https://api.sk.ukrfish.org/api/ai npx sudnokontrol-mcp

ソースから：

npm install
npm run build
node dist/index.js        # stdio
node dist/index.js http   # HTTP on :8958/mcp

ローカルインスタンスに接続

claude mcp add --transport http local-sudnokontrol http://127.0.0.1:8958/mcp

API（下で動くREST、MCPは不要）

レート制限：/api/ai/* に対し、IP ごと 15 分間で 300 リクエスト。Search/meta/stats のレスポンスは 60 秒間キャッシュされます。

例

User: Is the vessel УПС-4249 registered?

Agent calls: lookup_vessel {"registration_number": "УПС-4249"}
Response: { registration_number: "УПС-4249", name: "ua 5614 KV", owner_name: "ТОВ Соціальні ініціативи Запоріжжя", source: "registry", web_url: "https://sk.ukrfish.org/registry?vessel=УПС-4249", ... }

ライセンス

MIT

免責事項

本适配器は、SudnoKontrol が運用するウクライナ船舶登録データのためのオープンソース MCP アダプターであり、政府の公式サービスではありません。

Output