Skip to main content
Glama
SudnoKontrol MCP

SudnoKontrol MCP

by ailubes

SudnoKontrol MCP

Model Context Protocol-Server für das ukrainische nationale Schiffsregister — suchen Sie Schiffe nach Registrierungsnummer, Name oder Eigentümer, rufen Sie vollständige Registereinträge ab und fragen Sie aggregierte Statistiken ab. Stellt die öffentlichen Daten des Державний судновий реєстр України (staatliches Schiffsregister) sowie des Суднова книга України (Schiffsbuch) bereit.

Die Daten sind öffentlich und schreibgeschützt — kein API-Schlüssel erforderlich.

  • Gehosteter Endpunkt (empfohlen): https://api.sk.ukrfish.org/mcp (Streamable HTTP)

  • Offizielle Dokumentation: https://sk.ukrfish.org/api-docs und https://sk.ukrfish.org/info/ai-agents

  • Entdeckung: https://sk.ukrfish.org/llms.txt

Werkzeuge

Werkzeug

Beschreibung

search_vessel_registries

Volltext- und strukturierte Suche in beiden nationalen Registern. Deterministische Reihenfolge: exakt übereinstimmende Registrierungsnummern zuerst. Unterstützt kyrillische/lateinische und trennzeichenunempfindliche Nummern (УПС-0129 ≡ УПС 0129 ≡ UPS-0129).

lookup_vessel

Gezielte Schiffsabfrage anhand der normalisierten Registrierungsnummer. Liefert den vollständigen Registereintrag.

get_registry_stats

Aggregated öffentliche Schiffsanzahlen („wie viele Schiffe …“).

get_dataset_metadata

Datensatzkontext: Quellen, Importdaten, Datensatzanzahlen, Felder.

Jedes Such-/Lookup-Ergebnis enthält eine web_url → https://sk.ukrfish.org/registry? show=<reg>, über die Nutzer einen offiziellen Registerauszug bestellen können (PDF mit QR-Code-Verifizierung, 99,00 грн).

Related MCP server: Trimtab AIS

Schnellstart — gehosteter Server

Claude Code / Claude Desktop

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

Cursor

Settings → MCP → Add new MCP server → Name sudnokontrol, Typ HTTP, URL https://api.sk.ukrfish.org/mcp.

Windsurf

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

Jeder MCP-Client (Streamable HTTP)

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

Selbst betreiben

Der Server ist ein Proxy für die öffentliche API und benötigt keine Zugangsdaten.

# 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

Installieren Sie direkt aus diesem Repository:

npm install -g github:ailubes/sudnokontrol-mcp

Um eine andere Basis-URL anzugeben (z. B. Ihre eigene Bereitstellung):

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

Aus dem Quellcode:

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

Mit Ihrer lokalen Instanz verbinden

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

API (zugrunde liegendes REST, kein MCP erforderlich)

Endpunkt

Zweck

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

OpenAPI-3.1-Spezifikation

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

Funktionsaufruf-Tooldefinitionen (JSON : Store)

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

Datensatzkontext

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

Suche

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

Nachschlagen

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

Aggregierte Werte

Ratenlimit: 300 Anfragen / 15 Minuten / IP auf api/ai/*. Antworten für Suche/Meta/Statistik werden 60 Sekunden lang zwischengespeichert.

Beispiel

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", ... }

Lizenz

MIT

Haftungsausschluss

Dies ist ein Open-Source-MCP-Adapter für die public data of the Ukrainian vessel registries operated by SudnoKontrol. Er ist kein offizielles government service.

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.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    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