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 分