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: Korean Company Information MCP Server

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