SudnoKontrol

org.ukrfish.sk由 sk.ukrfish.org 發布官方發布者v1.0.1更新於 Oct 24, 2026

Ukrainian vessel registry: search by number/name/owner, full records, stats. No API key required.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

SudnoKontrol 讓助理檢索烏克蘭國家船舶登記冊與船舶簿的公開資料，依登記號查詢完整船舶紀錄，並取得船舶數量統計與資料集資訊。

可以做什麼
以自由文字和結構化條件檢索兩個國家船舶登記冊，登記號完全相符者優先，並相容西里爾／拉丁字母及分隔符差異。依登記號查詢單一船舶，回傳完整公開登記紀錄及連往公開船舶資訊頁面的連結。取得船舶彙總數量，以及資料來源、匯入日期、紀錄數與可用欄位等資料集中繼資料。
適用情境
適合需要確認某艘船舶是否在烏克蘭登記、依編號、名稱或船東查找船舶，或回答登記冊中共有多少船舶等問題。適用於以公開登記資料為基礎的查詢與查核工作。
執行需求
遠端 Streamable HTTP 端點，無需 API 金鑰或帳號。服務公開並依 IP 限流（每 15 分鐘 300 次請求）。也可選用 npx 在本機執行，需要 Node.js 及連往上游 API 的網路連線。
安裝前請注意
資料為唯讀公開資料，服務不需要任何憑證。結果為公開登記紀錄，其中船舶名稱與船東名稱可能涉及個人或企業資訊。專案聲明其並非官方政府服務，重要結論應向官方來源查證。請求依 IP 限流。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SudnoKontrol，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/org.ukrfish.sk%2Fsudnokontrol/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "sudnokontrol": {
      "type": "http",
      "url": "https://api.sk.ukrfish.org/mcp"
    }
  }
}

README

SudnoKontrol MCP

Model Context Protocol server for the Ukrainian national vessel registry — search vessels by registration number, name or owner, look up full registry records, and query aggregate statistics. Exposes the public data of the Державний судновий реєстр України (State Ship Registry) and the Суднова книга України (Ship Book).

Data is read-only and public — no API key required.

  • Hosted endpoint (recommended): https://api.sk.ukrfish.org/mcp (Streamable HTTP)
  • Project docs: https://sk.ukrfish.org/api-docs and https://sk.ukrfish.org/info/ai-agents
  • Discovery: https://sk.ukrfish.org/llms.txt

Tools

ToolDescription
search_vessel_registriesFree-text + structured search across both national registries. Deterministic ordering: exact registration-number matches first. Supports Cyrillic/Latin and separator-insensitive numbers (УПС-0129 ≡ УПС 0129 ≡ UPS-0129).
lookup_vesselExact vessel lookup by normalized registration number. Returns full registry record.
get_registry_statsAggregate public vessel counts ("how many vessels...").
get_dataset_metadataDataset context: sources, import dates, record counts, fields.

Every search/lookup result includes a web_url → https://sk.ukrfish.org/registry?vessel=<reg> pointing to the public vessel information page.

Quick start — hosted server

Claude Code / Claude Desktop

bash
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 → https://api.sk.ukrfish.org/mcp.

Any MCP client (streamable HTTP)

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

Run it yourself

The server proxies the public API and needs no credentials.

bash
# 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

Install from this repo directly:

bash
npm install -g github:ailubes/sudnokontrol-mcp

To point at a different base (e.g. your own deployment):

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

From source:

bash
npm installnpm run buildnode dist/index.js        # stdionode dist/index.js http   # HTTP on :8958/mcp

Connect to your local instance

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

API (underlying REST, no MCP needed)

EndpointPurpose
GET https://api.sk.ukrfish.org/api/ai/openapi.jsonOpenAPI 3.1 spec
GET https://api.sk.ukrfish.org/api/ai/toolsFunction-calling tool definitions (JSON Schema)
GET https://api.sk.ukrfish.org/api/ai/metaDataset context
GET https://api.sk.ukrfish.org/api/ai/registry/search?q=Search
GET https://api.sk.ukrfish.org/api/ai/registry/lookup/{reg}Lookup
GET https://api.sk.ukrfish.org/api/ai/statsAggregates

Rate limit: 300 requests / 15 min / IP on /api/ai/*. Search/meta/stats responses cached 60s.

Example

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

License

[M8ven Score]

MIT

Disclaimer

This is an open-source MCP adapter for the public data of the Ukrainian vessel registries operated by SudnoKontrol. It is not an official government service.

來源：README.md，提交 3f28a5d

工具

4

search_vessel_registries

Search Ukrainian national vessel registries

Search public data from the Ukrainian State Ship Registry and Ship Book by free-text query and structured filters. Deterministic ordering with exact registration-number matches first. Handles Cyrillic and Latin scripts and separator-insensitive numbers (УПС-0129 ≡ УПС 0129 ≡ UPS-0129). Each result includes a web_url pointing to the public vessel information page.

輸入參數qlimitoffsetsourcehome_portvessel_typebuild_year_maxbuild_year_min

lookup_vessel

Look up a Ukrainian vessel

Look up a vessel in the Ukrainian vessel registries using its registration number. Handles -, ., and space variance and Latin/Cyrillic forms. Returns the full public registry record, including a web_url pointing to the public vessel information page.

輸入參數registration_number必填

get_registry_stats

Get aggregate vessel counts

Aggregate public vessel counts for answering "how many vessels" questions.

無需輸入參數。

get_dataset_metadata

Describe available vessel-registry datasets

Describes available data sources (Державний судновий реєстр / Суднова книга), freshness (import dates), record counts, and available fields.

無需輸入參數。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分