SudnoKontrol

SudnoKontrol MCP

用于乌克兰国家船舶登记册的模型上下文协议服务——按登记号、名称或所有人搜索船舶，查询完整登记记录，以及检索汇总统计数据。公开提供 Державний судновий реєстр України（国家船舶登记册）和 Суднова книга України（乌克兰船舶簿）的数据。

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

• 托管端点（推荐）： https://api.sk.ukrfish.org/mcp（流式 HTTP）
• 项目文档： https://sk.ukrfish.org/api-docs 和 https://sk.ukrfish.org/info/ai-agents
• 发现： https://sk.ukrfish.org/llms.txt

工具

工具	描述
search_vessel_registries	在两个国家登记册中进行自由文本和结构化搜索。排序方式确定：登记号完全匹配的结果优先。支持西里尔字母/拉丁字母，且忽略编号中的分隔符（УПС-0129 ≡ УПС 0129 ≡ UPS-0129）。
lookup_vessel	按规范化的登记号精确查询船舶。返回完整登记记录。
get_registry_stats	船舶公开汇总数量（例如“有多少艘船……”）。
get_dataset_metadata	数据集上下文：来源、导入日期、记录数量和字段。

每条搜索/查询结果都包含一个 web_url → https://sk.ukrfish.org/registry?vessel=<reg>，指向公开的船舶信息页面。

快速开始 — 托管服务

Claude Code / Claude Desktop

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

Cursor

Settings → MCP → Add new MCP server → 名称 sudnokontrol，类型 HTTP，URL https://api.sk.ukrfish.org/mcp。

Windsurf

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

任意 MCP 客户端（可流式传输的 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）

端点	用途
GET https://api.sk.ukrfish.org/api/ai/openapi.json	OpenAPI 3.1 规范
GET https://api.sk.ukrfish.org/api/ai/tools	函数调用工具定义（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/registry/lookup/{reg}	查询
GET https://api.sk.ukrfish.org/api/ai/stats	汇总统计

速率限制：每个 IP 在 /api/ai/* 上每 15 分钟最多 300 个请求。搜索/元数据/统计响应缓存 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 适配器，用于 SudnoKontrol 运营的乌克兰船舶登记册公开数据。它不是官方政府服务。