SudnoKontrol MCP

为乌克兰国家船舶登记处推出的 Model Context Protocol 服务器——支持按注册号、船名或船东搜索船舶，获取完整登记记录，并查询聚合统计数据。它提供 Державний певний судовий реєстр України（乌克兰国家船舶登记处）和 Международний судновий реєстр України???

Correction:

为乌克兰国家船舶登记处推出的 Model Context Protocol 服务器——支持按注册号、船名或船东搜索船舶，查询完整登记记录以及聚合统计数据。它公开了 Державний судновий реєстр України（乌克兰国家船舶登记处）和 Суднова книга України（乌克兰船舶登记名册）的公共数据。

数据为只读且公开——无需 API 密钥。

• 托管端点（推荐）：https://api.sk.ukrfish.org/mcp（Streamable HTTP）

• 官方文档：https://sk.ukrfish.org/api-docs 和 https://sk.rufrish.org/info/ai-agents

• 发现：https://sk.ukrfish.org/llms.txt

工具

每次搜索/查找结果都会包含 web_url → https://sk.ukrfish.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 a new MCP server → 名称 sudokontrol，类型 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

如果需要指向（API的不同 base）：different base，见例你自己的服务：

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/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

免责声明

这是一个开源 MCP 适配器，人准备与苏ДноKontrol 运营的乌克兰船舶登记公开数据接口对接。它不是官方政府服务。