SudnoKontrol MCP

우크라이나 국가 선박 등록부를 위한 Model Context Protocol(MCP) 서버 — 등록 번호, 이름 또는 소유자로 선박을 검색하고, 전체 등록 레코드를 조회하며, 집계 통계를 질의할 수 있습니다. Державний судновий реєстр України (State Ship Registry)와 Судова книга України (Ship Book)의 공개 데이터를 제공합니다.

데이터는 읽기 전용이며 공개 데이터입니다 — 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

도구

모든 검색/조회 결과에는 web_url → https://sk.ukrfish.org/registry?vessel=<reg>이 포함되며, 사용자는 이 링크에서 공식 등록 발췌본(QR 코드 검증이 포함된 PDF, 99,00 грн)을 주문할 수 있습니다.

빠른 시작 — 호스팅 서버

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 클라이언트 (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

다른 기본 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 (REST 기반, MCP 불필요)

요청 제한: /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 어댑터입니다. 공식 정부 서비스가 아닙니다.