Skip to main content
Glama

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.db

Requirements

  • Python 3.10+

  • uv (권장) 또는 pip

  • Docker (컨테이너 실행 시)

Local Installation

git clone <your-repo-url>
cd ShipMCP
uv sync

pip 사용 시:

pip install .

Run

기본(권장) STDIO 모드:

uv run ship-mcp

모듈 직접 실행:

uv run python -m ship_mcp.server

HTTP 모드 예시:

# 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 8000

Docker

이미지 빌드:

docker build -t ship-mcp:latest .

기본 실행(HTTP, 8000 포트):

docker run --rm -p 8000:8000 ship-mcp:latest

DB를 호스트에 영속화:

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

Tests

python -m unittest discover -s tests -v

Usage Examples

권장 호출 순서:

  1. search_ship_terms 로 후보 검색

  2. get_term_detail 로 상세 정보 조회

  3. 필요 시 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.db

Development Notes

  • 엔트리포인트: ship-mcp = ship_mcp.server:main

  • 기본 전송 프로토콜: stdio

  • 지원 전송 프로토콜: stdio, sse, streamable-http

  • 데이터 계층: ship_mcp/data/repository.py

License

MIT

Available Tools

6 tools
get_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

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    6 tools is well-scoped for a terminology reference server. Each tool serves a necessary function without redundancy or bloat.

    Completeness5/5

    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

    Related MCP Servers

    • F
      license
      A
      quality
      B
      maintenance
      Enables 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.
      26
      2
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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