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

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 грн).

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)

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.