СудноКонтроль

MCP-сервер для AI-агентів

Дайте вашому Claude, ChatGPT чи іншому агенту доступ до публічного реєстру маломірних суден України. Коли користувачу потрібне офіційне підтвердження — спрямуйте його на сайт для замовлення витягу.

Відкритий код на GitHub

MCP-сервер СудноКонтроль — це відкритий проєкт (MIT ліцензія). Ви можете використовувати готовий хостинг або запустити сервер самостійно.

github.com/ailubes/sudnokontrol-mcp

Опубліковано в офіційному MCP Registry: org.ukrfish.sk/sudnokontrol

Інструменти

  • search_vessel_registries — пошук суден за номером, назвою або власником
  • lookup_vessel — повний запис судна за реєстраційним номером
  • get_registry_stats — статистика кількості суден
  • get_dataset_metadata — джерела даних, дати імпорту, поля

Кожен результат містить посилання web_url → /registry?vessel=..., де користувач може замовити офіційний витяг (99 грн).

Як підключити

  1. Хостинг (рекомендовано) — один URL

    Використовуйте готовий хостинг, нічого встановлювати не потрібно. Підключіть URL https://api.sk.ukrfish.org/mcp у своєму MCP-клієнті.

    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
Type: HTTP
URL: https://api.sk.ukrfish.org/mcp

    Windsurf

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

  2. Або запустіть на своєму сервері

    npx sudnokontrol-mcp              # stdio
npx sudnokontrol-mcp http         # HTTP :8958/mcp
# або з репозиторію:
npm install -g https://github.com/ailubes/sudnokontrol-mcp/archive/refs/heads/main.tar.gz

  3. Прямий REST (без MCP)

    Не користуєтесь MCP? Використовуйте REST-API напряму: https://api.sk.ukrfish.org/api/ai/registry/search?q=УПС-0129. Повна документація — openapi.json.

Детальніше

Документація API GitHub репозиторій Відкрити реєстр суден