Skip to main content
Glama
SudnoKontrol MCP

SudnoKontrol MCP

by ailubes

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

도구

도구

설명

search_vessel_registries

두 국가 등록부 모두를 대상으로 하는 자유 텍스트 + 구조화 검색. 결정적 정렬: 정확한 등록 번호 일치가 먼저 나옵니다. 키릴/라틴 문자 및 구분자에 영향받지 않는 번호를 지원합니다 (УПС-0129 ≡ УПС 0129 ≡ UPS-0129).

lookup_vessel

정규화된 등록 번호로 정확한 선박 조회. 전체 등록 레코드를 반환합니다.

get_registry_stats

집계 공개 선박 수("선박이 몇 척인가").

get_dataset_metadata

데이터셋 맥락: 출처, 가져온 날짜, 레코드 수, 필드.

모든 검색/조회 결과에는 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/mcp

Cursor

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/mcp

API (REST 기반, MCP 불필요)

엔드포인트

용도

GET https://api.sk.ukrfish.org/api/ai/openapi.json

OpenAPI 3.1 스펙

GET https://api.sk.ukrfish.org/api/ai/tools

함수 호출 도구 정의 (JSON Schema)

GET https://api.sk.ukrfish.org/api/ai/meta

데이터셋 맥락

GET https://api.sk.ukrfish.org/api/ai/registry/search?q=

검색

GET https://api.sk.ukrfish.org/api/ai/registry/lookup/{reg}

조회

GET https://api.sk.ukrfish.org/api/ai/stats

집계

요청 제한: /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 tools
get_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

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    4 tools is well-scoped for a read-only registry API. Each tool covers a necessary operation without redundancy or bloat.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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 npm
      50
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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 npm
      MIT