SudnoKontrol MCP

Сервер Model Context Protocol для национального судового реестра Украины — поиск судов по регистрационному номеру, названию или владельцу, просмотр полных записей реестра и получение сводной статистики. Предоставляет открытые данные государственных реестров: Державний судовий реєстр України (Государственный судовой реестр Украины) и Суднова книга України (Судовая книга Украины).

Данные публичны и доступны только для чтения — API-ключ не требуется.

• Размещённый endpoint (рекомендуется): https://api.sk.ukfish.org/mcp (Streamable HTTP)

• Официальная документация: https://sk.ukfish.org/api-docs и https://sk.ukfish.org/info/ai-agents

• Обнаружение: https://sk.ukfish.org/llms.txt

Инструменты

Каждый результат поиска или запроса содержит web_url → https://sk.ukfish.org/registry?vessel=<reg>, где пользователи могут заказать официальную выписку из реестра (PDF с проверкой по QR-коду, 99,00 грн).

Быстрый старт — размещённый сервер

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.ukfish.org/mcp.

Windsurf

Windsurf → MCP → Add server → https://api.sk.ukfish.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 не требуется)

Ограничение скорости: 300 запросов / 15 минут / IP по /api/ai/*. Ответы search/meta/stats кэшируются 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

Отказ от ответственности

Это адаптер MCP с открытым исходным кодом для публичных данных украинских судовых реестров, управляемых SudnoKontrol. Не является официальным государственным сервисом.