SudnoKontrol MCP
SudnoKontrol MCP
우크라이나 국가 선박 등록부를 위한 Model Context Protocol(MCP) 서버 — 등록 번호, 이름 또는 소유자로 선박을 검색하고, 전체 등록 레코드를 조회하며, 집계 통계를 질의할 수 있습니다. Державний судновий реєстр України (State Ship Registry)와 Судова книга України (Ship Book)의 공개 데이터를 제공합니다.
데이터는 읽기 전용이며 공개 데이터입니다 — 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 грн)을 주문할 수 있습니다.
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 → 이름 sudnokontrol, 유형 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다른 기본 URL(예: 자체 배포)을 지정하려면:
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 불필요)
엔드포인트 | 용도 |
| OpenAPI 3.1 스펙 |
| 함수 호출 도구 정의 (JSON Schema) |
| 데이터셋 맥락 |
| 검색 |
| 조회 |
| 집계 |
요청 제한: /api/ai/*에서 IP당 15분에 300건. 검색/메타/통계 응답은 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 어댑터입니다. 공식 정부 서비스가 아닙니다.
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.
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