ShipMCP
ShipMCP is a specialized MCP server that helps LLMs accurately understand and work with Korean/English shipbuilding terminology.
Tools
Search terms: Search shipbuilding terminology by keyword in English or Korean, returning IDs, names, abbreviations, and descriptions
Get term details: Retrieve full details (description, category, synonyms, related terms) by term ID, English name, or Korean name (e.g., '용골' → Keel)
Browse by category: List all terms within a specific category across 14 available categories (e.g., hull-structure, propulsion, navigation, cargo, safety)
List categories: Get all available terminology categories with their IDs, names, and descriptions
Translate terms: Translate shipbuilding terms between English and Korean in either direction
Get statistics: Retrieve database stats including total term count (364), category count (14), and per-category distribution
Resources
Access static/queryable data including category listings, individual term data, search results, and a full glossary via
shipmcp://URIs
Prompts
Use built-in reusable templates to learn a term, generate a Korean-English glossary, explain shipbuilding documents, or compare two terms
Deployment
Supports stdio (local), streamable HTTP, or SSE transport, with Docker support and persistent database storage
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ShipMCP What is a keel?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ShipMCP
조선/선박 전문 용어를 LLM이 정확히 이해하도록 돕는 MCP 서버입니다.
Korean + English shipbuilding terminology
조선소 실무에서 자주 쓰는 설계/생산/선급/IMO 용어 포함
MCP 표준 Primitive(Resources, Tools, Prompts) 제공
What This Server Provides
1) Resources
클라이언트가 컨텍스트로 로드할 수 있는 정적/조회형 데이터입니다.
shipmcp://categories
shipmcp://category/{category_id}
shipmcp://term/{term_id}
shipmcp://search/{query}
shipmcp://glossary
2) Tools
모델이 호출할 수 있는 실행형 함수입니다.
search_ship_terms(query, max_results=10)
get_term_detail(term_id_or_name)
list_terms_by_category(category_id)
list_categories_tool()
translate_term(term, from_lang="en", to_lang="ko")
get_term_statistics()
3) Prompts
재사용 가능한 프롬프트 템플릿입니다.
learn_term(term_name)
korean_english_glossary(category="all")
explain_document(text)
compare_terms(term1, term2)
Related MCP server: Bible MCP
Data Coverage
현재 데이터 기준:
Categories: 14
Terms: 364
카테고리 목록:
ship-types
hull-structure
propulsion
navigation
cargo
safety
shipbuilding-process
ship-dimensions
design
marine-engineering
mooring-anchoring
electrical
classification
welding-fabrication
Data Storage (SQLite)
용어 데이터는 로컬 SQLite 파일 DB로 관리됩니다.
기본 DB 경로: ship_mcp/data/ship_terms.db
환경변수: SHIP_MCP_DB_PATH
CLI 옵션: --db-path
사용자 DB 경로를 지정했을 때 파일이 비어 있으면, 패키지 기본 DB를 복제해 초기화합니다.
예시:
# PowerShell
$env:SHIP_MCP_DB_PATH = "C:\path\to\ship_terms.db"
uv run ship-mcp
# 또는 옵션 사용
uv run ship-mcp --db-path C:\path\to\ship_terms.dbRequirements
Python 3.10+
uv (권장) 또는 pip
Docker (컨테이너 실행 시)
Local Installation
git clone <your-repo-url>
cd ShipMCP
uv syncpip 사용 시:
pip install .Run
기본(권장) STDIO 모드:
uv run ship-mcp모듈 직접 실행:
uv run python -m ship_mcp.serverHTTP 모드 예시:
# Streamable HTTP
uv run ship-mcp --transport streamable-http --host 0.0.0.0 --port 8000
# SSE
uv run ship-mcp --transport sse --host 127.0.0.1 --port 8000Docker
이미지 빌드:
docker build -t ship-mcp:latest .기본 실행(HTTP, 8000 포트):
docker run --rm -p 8000:8000 ship-mcp:latestDB를 호스트에 영속화:
docker run --rm -p 8000:8000 -v shipmcp-data:/data ship-mcp:latest실행 옵션 변경(환경변수):
docker run --rm -p 9000:9000 \
-e SHIP_MCP_TRANSPORT=streamable-http \
-e SHIP_MCP_HOST=0.0.0.0 \
-e SHIP_MCP_PORT=9000 \
-e SHIP_MCP_DB_PATH=/data/ship_terms.db \
-v shipmcp-data:/data \
ship-mcp:latest참고: Docker 이미지는 기본적으로 HTTP 배포용(streamable-http)으로 설정되어 있습니다.
MCP Client Setup
Claude Desktop
claude_desktop_config.json 예시:
{
"mcpServers": {
"shipmcp": {
"command": "uv",
"args": ["run", "--directory", "C:\\path\\to\\ShipMCP", "ship-mcp"],
"env": {}
}
}
}Claude Code
claude mcp add shipmcp -- uv run --directory "C:\\path\\to\\ShipMCP" ship-mcpTests
python -m unittest discover -s tests -vUsage Examples
권장 호출 순서:
search_ship_terms 로 후보 검색
get_term_detail 로 상세 정보 조회
필요 시 translate_term 으로 번역
예시 질의:
용골이 뭐야?
DWT 뜻 알려줘
Bulk Carrier와 Tanker 차이 비교
이 문단의 조선 용어를 풀어서 설명해줘
Project Structure
ShipMCP/
├─ Dockerfile
├─ pyproject.toml
├─ README.md
├─ tests/
│ ├─ test_repository.py
│ └─ test_server_tools.py
└─ ship_mcp/
├─ __init__.py
├─ server.py
└─ data/
├─ __init__.py
├─ repository.py
└─ ship_terms.dbDevelopment Notes
엔트리포인트: ship-mcp = ship_mcp.server:main
기본 전송 프로토콜: stdio
지원 전송 프로토콜: stdio, sse, streamable-http
데이터 계층: ship_mcp/data/repository.py
License
MIT
Available Tools
6 toolsget_term_detailA
Get detailed information about a specific shipbuilding term. IMPORTANT: Call this after search_ship_terms() to get FULL details. Works with Korean names too! e.g. get_term_detail("용골") returns keel details.
Args: term_id_or_name: The term's unique ID (e.g. 'bulk-carrier'), English name, or Korean name (e.g. '용골', '벌크선')
Returns: Detailed term information including descriptions, category, synonyms, and related terms
Inputs: term_id_or_name (required). Returns: result
get_term_statisticsB
Get statistics about the shipbuilding terminology database.
Returns: Count of terms, categories, and category-wise distribution
Inputs: no named parameters. Returns: object
list_categories_toolA
List all shipbuilding terminology categories.
Returns: All available categories with their IDs, names, and descriptions
Inputs: no named parameters. Returns: result
list_terms_by_categoryA
List all shipbuilding terms in a specific category.
Args: category_id: The category ID. Available: ship-types, hull-structure, propulsion, navigation, cargo, safety, shipbuilding-process, ship-dimensions, design, marine-engineering, mooring-anchoring, electrical, classification, welding-fabrication
Returns: A list of terms in the category with basic info
Inputs: category_id (required). Returns: result
search_ship_termsA
Search shipbuilding terminology by keyword. IMPORTANT: Use this for ANY shipbuilding question, including Korean terms!
Searches across English terms, Korean terms (한국어), abbreviations, and descriptions. Example: search_ship_terms("용골") will find "Keel" Example: search_ship_terms("DWT") will find "Deadweight Tonnage"
Args: query: The keyword or phrase to search for (English or Korean — both work!) max_results: Maximum number of results to return (default 10, max 50)
Returns: A list of matching terms with id, English, Korean, abbreviation, and description
Inputs: query (required), max_results. Returns: result
translate_termA
Translate a shipbuilding term between English and Korean.
Args: term: The term to translate (English or Korean) from_lang: Source language ('en' or 'ko', default 'en') to_lang: Target language ('en' or 'ko', default 'ko')
Returns: The translated term and related information
Inputs: term (required), to_lang, from_lang. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a distinct, non-overlapping purpose: detailed term lookup, database statistics, category listing, category-specific term listing, keyword search, and translation. No ambiguity.
All tools follow a verb_noun pattern with snake_case, though 'list_categories_tool' has a redundant '_tool' suffix and 'translate_term' omits the second underscore. Still, the pattern is clear and predictable.
6 tools is well-scoped for a terminology reference server. Each tool serves a necessary function without redundancy or bloat.
The tools provide full read-only coverage: search, list by category, get details, translate, and view statistics. No CRUD gaps since the server likely only exposes a read-only database. All common lookup workflows are supported.
Related MCP Connectors
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Korean fact-verification tools for AI agents: business registration, address, DART, apt prices, laws
All KR Data tools in one server: Korean business checks, addresses, laws, car flood records & more
AEC Expert Knowledge Curation System. Korean building codes, statutes and practice, with sources.
Related MCP Servers
- FlicenseAqualityBmaintenanceEnables AI systems to search, retrieve, and analyze Korean legal information from the National Law Information API (law.go.kr), including laws, administrative rules, English translations, and law-ordinance linkages.262-
- FlicenseNot gradedqualityDmaintenanceEnables local-first semantic search and retrieval of Korean Bible verses using FAISS embeddings and full-text indexes. Supports exploration of biblical entities including people, places, and events with Korean-to-English query handling.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, retrieve, and analyze South Korean legal documents including statutes, precedents, constitutional decisions, and administrative rulings via the Ministry of Government Legislation Open API. Provides 89 specialized tools with features like legal abbreviation auto-recognition, annex extraction, and complex research chain workflows.MIT

Datalastic MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables real-time vessel tracking, port data, maritime weather, and maritime intelligence through 25 tools, allowing AI clients to query live vessel positions, registry, port info, area searches, weather, and more.MIT