SudnoKontrol

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	2つの国立登録簿を対象に、フリーテキストと構造化検索を行います。順序は決定的で、登録番号の完全一致が先に表示されます。キリル文字／ラテン文字に対応し、番号の区切り文字は無視されます（УПС-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

別のベースURL（例：独自のデプロイ先）を指定するには、次のようにします。

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（MCP不要の基盤REST API）

エンドポイント	用途
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	集計情報

レート制限：/api/ai/* へのリクエストは、IPあたり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

免責事項

これは、SudnoKontrolが運営するウクライナ船舶登録簿の公開データを利用するオープンソースのMCPアダプターです。政府の公式サービスではありません。