SudnoKontrol MCP

Servidor del Model Context Protocol para el registro nacional de buques de Ucrania: buscar buques por número de registro, nombre o propietario, consultar los registros completos y obtener estadísticas agregadas. Expone los datos públicos del Державний судновий реєстр України (Registro Estatal de Buques) y de la Суднова книга України (Libro de Buques).

Los datos son de solo lectura y públicos — no se requiere ninguna clave de API.

• Endpoint alojado (recomendado): https://api.sk.ukrfish.org/mcp (Streamable HTTP)

• Documentación oficial: https://sk.ukrfish.org/api-docs y https://sk.ukrfish.org/info/ai-agents

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

Herramientas

Cada resultado de búsqueda/consulta incluye un web_url → https://sk.ukrfish.org/registry?vessel=<reg> desde el que los usuarios pueden encargar un extracto oficial del registro (PDF con verificación de código QR, 99,00 грн).

Inicio rápido — servidor alojado

Claude Code / Claude Desktop

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

Cursor

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

Windsurf

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

Cualquier cliente MCP (streamable HTTP)

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

Ejecútalo tú mismo

El servidor actúa como proxy de la API pública y no necesita credenciales.

# 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

Instala directamente desde este repositorio:

npm install -g github:ailubes/sudnokontrol-mcp

Para apuntar a una base distinta (p. ej., tu propio despliegue):

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

Desde el código fuente:

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

Conecta con tu instancia local

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

API (REST subyacente, sin necesidad de MCP)

Límite de peticiones: 300 solicitudes / 15 min / IP en /api/ai/*. Las respuestas de búsqueda, metadatos y estadísticas se guardan en caché durante 60 s.

Ejemplo

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

Licencia

MIT

Aviso legal

Este es un adaptador MCP de código abierto para los datos públicos de los registros de buques de Ucrania gestionados por SudnoKontrol. No es un servicio gubernamental oficial.