SudnoKontrol MCP
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
ツール
ツール | 説明 |
| 両方の国家登録を横断するフリーテキスト+構造化検索。並び順は決定的で、登録番号の完全一致が最初になります。キリル/ラテン文字、区切り文字の有無にかかわらず対応<span( |
| 正規化された登録番号による船舶の特定検索。完全な登録記録を返します。 |
| 公開されている船舶総数の集計(「何隻の船...」)。 |
| データセットの背景情報:出典、取込日、レコード件数、フィールド。 |
すべての検索・照会結果には web_url → https://sk.ukrfish.org/registry?vessel=<reg> が含まれ、そこから 公式の登録簿抄本(QRコード検証付きPDF、99,00 грн) を注文できます。
Related MCP server: Trimtab AIS
クイックスタート — ホスト型サーバー
Claude Code / Claude Desktop
claude mcp add --transport http sudnokontrol https://api.sk.ukrfish.org/mcpCursor
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/mcpAPI(下で動くREST、MCPは不要)
API | メソンドポイント | 目的 |
| OpenAPI 3.1 仕様 | |
| 関数呼び出し用 tool 定義(JSON Schema) | |
| データセット情報 | |
| 検索 | |
| 照会 | |
| 集計 |
レート制限:/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
Available Tools
4 toolsget_dataset_metadataDescribe available vessel-registry datasetsAInspect
Describes available data sources (Державний судновий реєстр / Суднова книга), freshness (import dates), record counts, and available fields.
Inputs: no named parameters.
get_registry_statsGet aggregate vessel countsAInspect
Aggregate public vessel counts for answering "how many vessels" questions.
Inputs: no named parameters.
lookup_vesselLook up a vessel by registration numberAInspect
Exact vessel lookup by normalized registration number (handles -, ., and space variance, and Latin/Cyrillic forms). Returns full registry data plus a web_url to the public site for ordering an official excerpt.
Inputs: registration_number (required).
search_vessel_registriesSearch Ukrainian national vessel registriesAInspect
Search Державний судновий реєстр України and Суднова книга України by free-text query and structured filters. Deterministic ordering with exact registration-number matches first. Each result includes a web_url linking to the public site for ordering an official registry excerpt.
Inputs: q, limit, offset, source, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct purpose: dataset metadata, free-text search, exact registration-number lookup, and aggregate statistics. No overlaps in function; even search and lookup are clearly separated by exact vs. fuzzy matching.
All tool names follow the same verb_noun snake_case convention: get_dataset_metadata, search_vessel_registries, lookup_vessel, get_registry_stats. Consistent and predictable.
4 tools is well-scoped for a read-only registry API. Each tool covers a necessary operation without redundancy or bloat.
The surface fully covers the domain's read-side: metadata discovery, flexible search, exact lookup, and statistics. No essential operations are missing for the stated purpose.
Maintenance
Related MCP Connectors
Vessel tracking for 750,000+ ships, with ownership, inspections, port records, routes, and more.
Maritime intelligence: vessels, tracks, port calls, company fleets and sanctions screening, sourced.
Public Data Ukraine Mcp connects AI agents to real public APIs via MCP. Tools include
Official public & government APIs, dozens of countries: registers, statistics, open data. Keyless.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides seamless access to official Ukrainian government statistics from the State Statistics Service via their SDMX API. It enables users to query bilingual datasets across domains like energy, demographics, and trade using flexible filtering and metadata exploration tools.5 npm50MIT
- AlicenseNot gradedqualityDmaintenanceProvides real-time, machine-readable ship and port conditions for major US container gateways using AIS data, allowing AI agents to query vessel status, berthing events, and gateway conditions without API keys or signup.1Apache 2.0

Datalastic MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables real-time vessel tracking, port data, maritime weather, and maritime intelligence through 25 tools, allowing AI clients to query live vessel positions, registry, port info, area searches, weather, and more.MIT- AlicenseNot gradedqualityCmaintenanceProvides live vessel positions from Fintraffic's AIS receivers in Finnish and Baltic waters, with tools to query vessels near a point, count vessels in an area, and get details by MMSI. No authentication required.80 npmMIT