Jikgu Customs MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
직구 관세 비서 (Jikgu Customs Assistant) — MCP Server
해외직구 예상 관세·부가세와 통관 규칙을 계산하는 MCP 서버. 외부 API 호출 없이 순수 계산으로 동작해 응답이 빠르고(로컬 왕복 ~7ms), 모든 툴이 read-only입니다.
Transport: Streamable HTTP, stateless, 포트
8000, 경로/mcpFastMCP 3.x (MCP 프로토콜
2025-06-18)결과는 정제된 마크다운 텍스트(raw JSON 덤프 아님)
모든 결과는 공개된 관세 규정 기반 예상치입니다. 실제 부과 세액은 HS 코드·품목 상세·환율·통관 시점에 따라 다를 수 있습니다. 정확한 값은 관세청 '해외직구물품 예상세액 조회'(customs.go.kr) 또는 콜센터(125)로 확인하세요.
툴 (4개)
툴 | 설명 |
| 물품가격·국제배송비·발송국·품목으로 목록통관/일반통관 판정 + 면세 여부 + 예상 세액(간이세율) |
| 품목이 목록통관 배제 대상인지 판정 + 이유 + 대안 |
| 여러 주문의 합산과세 위험 판정(2022-11-17 개정 규칙) |
| 통관 절차·함정 설명(정적 지식) |
모든 툴 annotations: readOnlyHint=true, destructiveHint=false,
openWorldHint=false, idempotentHint=true, title 지정.
Related MCP server: tariffmonitor-mcp
로컬 실행
# uv (권장)
uv venv --python 3.11 .venv
uv pip install --python .venv/bin/python -r requirements.txt
.venv/bin/python server.py
# 또는 venv + pip
python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python server.py서버는 http://0.0.0.0:8000/mcp 에서 Streamable HTTP로 대기합니다.
테스트
.venv/bin/python -m pytest -qMCP Inspector로 테스트
npx @modelcontextprotocol/inspectorInspector에서 Transport Streamable HTTP, URL http://127.0.0.1:8000/mcp 로 연결 →
tools/list로 4개 툴 확인 → calculate_import_duty 등을 호출.
curl로 핸드셰이크 확인
BASE=http://127.0.0.1:8000/mcp
# initialize
curl -sS -L -X POST "$BASE" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
# tools/list
curl -sS -L -X POST "$BASE" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
# tools/call
curl -sS -L -X POST "$BASE" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"calculate_import_duty","arguments":{"goods_price_usd":250,"intl_shipping_usd":30,"country":"US","category":"clothing","exchange_rate_krw_per_usd":1400}}}'Accept 헤더에 text/event-stream 이 없으면 406이 납니다. 응답은 SSE(data: {...})로 옵니다.
Docker
docker build -t jikgu-customs-mcp .
docker run -p 8000:8000 jikgu-customs-mcp도메인 규칙·출처
SPEC.md 참고. 관세 규칙은 관세청/찾기쉬운 생활법령정보/관세법 시행령 기준으로
검증했으며, 코드 상수마다 출처 URL과 검증 상태(VERIFIED/UNVERIFIED)를 주석으로 표기.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
EU import duty & VAT calculator (rules since 1 July 2026), real shop origins and shipping rates.
Landed cost, fees & profit calculators for cross-border Amazon, TikTok Shop and Shopify sellers.
Find an HS code, HTS code or customs code, and read the customs duty or import tax.
US HTS duty lookup and import-duty review with official sources and explicit unresolved layers.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perform international trade operations such as calculating landed costs, classifying goods, explaining trade terms, estimating shipping, and converting currencies for Kazakhstan/EAEU/Central Asia trade routes.14 npmMIT
- AlicenseAqualityCmaintenanceLive US import tariff calculator covering 19,856 HTS codes, allowing AI to look up stacked tariff rates and project the November 10, 2026 cliff impact on any product.2739 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides access to US import tariff rates via the USITC Harmonized Tariff Schedule, enabling natural language queries for tariff data.127 npmMIT
- AlicenseBqualityBmaintenanceTurns your AI assistant into a US import duty research tool, enabling HTS code lookup, landed-cost calculation, and tariff change tracking using official USITC data.5174 npm3MIT