Skip to main content
Glama
SudnoKontrol MCP

SudnoKontrol MCP

by ailubes

SudnoKontrol MCP

ウクライナ国家船舶登録のための Model Context Protocol サーバーです。登録番号・船名・所有者による船舶の検索、完全な登録記録の照会、集計統計の取得ができます。Державний судновий реєстр України(ウクライナ国家船舶登録簿)と Суднова книга України(ウクライナ船舶台帳)の公開データを公開しています。

データは読み取り専用で公開されており、API キーは不要です。

  • ホスト型エンドポイント(推奨): https://api.sk.ukrfish.org/mcp(Streamable HTTP)

  • 公式ドキュメント: https://sk.ukrfish.org/api-docs と https://sk.ukrfish.org/info/ai-agents

  • ディスカバリー: https://sk.ukrfish.org/llms.txt

ツール

ツール

説明

search_vessel_registries

両方の国家登録を横断するフリーテキスト+構造化検索。並び順は決定的で、登録番号の完全一致が最初になります。キリル/ラテン文字、区切り文字の有無にかかわらず対応<span(УПС-0129 ≡ УПС 0129 ≡ UPS-0129)。

lookup_vessel

正規化された登録番号による船舶の特定検索。完全な登録記録を返します。

get_registry_stats

公開されている船舶総数の集計(「何隻の船...」)。

get_dataset_metadata

データセットの背景情報:出典、取込日、レコード件数、フィールド。

すべての検索・照会結果には web_url → https://sk.ukrfish.org/registry?vessel=<reg> が含まれ、そこから 公式の登録簿抄本(QRコード検証付きPDF、99,00 грн) を注文できます。

Related MCP server: Trimtab AIS

クイックスタート — ホスト型サーバー

Claude Code / Claude Desktop

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

Cursor

Settings → MCP → Add new MCP server → Name sudToast、Type HTTP、URL https://api.sk.ukrfish.org/mcp。

Windsurf

Windsurf → MCP → Add server → https://api.sk.ukrfish.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

別のベース先に向ける場合(例:自デプロク):

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は不要)

API

メソンドポイント

目的

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

OpenAPI 3.1 仕様

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

関数呼び出し用 tool 定義(JSON Schema)

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

データセット情報

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

検索

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

照会

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

集計

レート制限:/api/ai/* に対し、IP ごと 15 分間で 300 リクエスト。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

免責事項

本适配器は、SudnoKontrol が運用するウクライナ船舶登録データのためのオープンソース MCP アダプターであり、政府の公式サービスではありません。

Output

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