Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

CLNS — Korea Import Compliance

by CLNS-KRversion 0.2.0i★ 0iRuns in the cloudOfficial site ↗
Registry nameio.github.CLNS-KR/clns

How to install

What it does

Korea import pre-check: clearance requirements, MFDS history, recalls, RRA conformity, statutes.

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Law & government data

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score20/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install CLNS — Korea Import Compliance. Follow https://mcp.popnx.com/i/clns-kr-clns.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (clns-kr.onrender.com) · ✓ Commands checked Nov 18, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameCLNS — Korea Import Compliance
    Remote MCP server URL · Addresshttps://clns-kr.onrender.com/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsCLNS — Korea Import Compliance

  4. Try it

    Use CLNS — Korea Import Compliance and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using CLNS — Korea Import Compliance or shows a CLNS — Korea Import Compliance tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameCLNS — Korea Import Compliance
    Connection · Addresshttps://clns-kr.onrender.com/mcp
  3. Pick CLNS — Korea Import Compliance in a chat

    Start a new chat and pick CLNS — Korea Import Compliance from your plugins before typing

  4. Try it

    Use CLNS — Korea Import Compliance and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using CLNS — Korea Import Compliance or shows a CLNS — Korea Import Compliance tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user clns https://clns-kr.onrender.com/mcp
  3. Type /mcp in Claude Code

    You should see CLNS — Korea Import Compliance listed as connected

  4. Try it

    Use CLNS — Korea Import Compliance and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using CLNS — Korea Import Compliance or shows a CLNS — Korea Import Compliance tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use CLNS — Korea Import Compliance and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using CLNS — Korea Import Compliance or shows a CLNS — Korea Import Compliance tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use CLNS — Korea Import Compliance and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using CLNS — Korea Import Compliance or shows a CLNS — Korea Import Compliance tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://clns-kr.onrender.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use CLNS — Korea Import Compliance💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user clns https://clns-kr.onrender.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "clns": {
      "url": "https://clns-kr.onrender.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "clns": {
      "type": "http",
      "url": "https://clns-kr.onrender.com/mcp"
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
0.2.0
Published to registryi
Nov 19, 2026
Code last changedi
Nov 19, 2026
Last checked
Nov 18, 2026
Maker
CLNS-KR
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 18, 2026. The maker wrote them, not us; we show them as plain text.

  • assess_import_case

    품목·상황을 자연어로 받아 수입요건·인증·표시·통관 함정을 3단계로 판정하고 근거 조항과 면책을 반환합니다.

  • lookup_hs_requirements

    HS 코드로 세관장확인대상 여부·법령·기관을 판정합니다. 6자리는 요건 판정에 부족합니다.

  • check_kc_certification

    전기용품·생활용품·어린이제품·전파 적합성평가 중 어떤 절차가 걸리는지 판정합니다.

  • check_food_cosmetics

    수입신고·영업등록·한글표시·광고심의 등 식약처 요건을 판정합니다.

  • lookup_recall

    브랜드·모델명·제품명으로 국내 리콜 이력을 조회합니다. 로컬 인덱스(국표원 15040696) 우선, 없으면 소스 미연결을 그대로 알립니다.

  • get_legal_basis

    코퍼스에 수록된 법령 조항의 요지·시행일·원문 URL을 반환합니다.

  • explain_trap

    케이스 ID(TRAP-01~20)의 시나리오, 흔한 AI 오답, 정답, 근거를 반환합니다.

  • get_service_meta

    코퍼스 버전, 3단계 판정 정의, 무료/유료 경계, 잔여 호출 수를 반환합니다.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account CLNS-KR, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 393 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 8 tool descriptions and found no hidden instructions to the AI

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/clns-kr-clns.svg)](https://mcp.popnx.com/en/servers/clns-kr-clns)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Law & government datai

  • More stars than 0% of the other 1961 servers in this category
  • Published to the registry more recently than 97% of the other 1961 servers in this category
  • Basic checks equal to or better than 99% of the other 1961 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is CLNS — Korea Import Compliance safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (0.2.0) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

by lexifinaWidely used★ 2.1KUpdated 10 days ago

Runs in the cloud✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

by librejusticeEarly★ 38Updated 2 months ago

Runs in the cloud✓ service owner · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

by street1983nkEarly★ 18Updated 5 months ago

Runs in the cloud✓ service owner · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

by JayTheSkierEarly★ 8Updated 7 months ago

Runs in the cloud✓ service owner · fedlex-connector.ch
Compared with similar ones
This one
CLNS — Korea Import Compliance
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks5/54/44/44/44/44/4
LicenseMITNOASSERTIONMITApache-2.0Apache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.


title: "CLNS — PRODUCT COMPLIANCE INTELLIGENCE · KOREA"


CLNS

PRODUCT COMPLIANCE INTELLIGENCE · KOREA

Clearance, simplified.

복잡한 한국 수입 규제를 10초 만에 확인

Korea Import Compliance MCP & API — 한국 수입·구매대행·유통 실무에서 범용 AI가 자주 틀리는 요건을 3단계로 판정하고, 근거 법령 조항·시행일·원문 URL과 국/영문 면책을 함께 반환하는 경량 엔진입니다.

  • 라이브: [https://clns-kr.onrender.com](https://clns-kr.onrender.com) (무료 베타 · Render free Web Service)
  • 결제 없음 · 100% 무료 베타 · 회원가입 없음
  • 외부 API 키가 없어도 동작(코퍼스 기반). 키를 넣으면 관세청·식약처·법제처 공공 API를 실시간 호출하고, 실패 시 캐시로 폴백. 전파 적합성평가(국립전파연구원)는 키가 필요 없는 공개 API라 번호만 있으면 바로 조회한다
  • 원본 API 재전송 없음 — 결합·정규화한 판정만 출력
  • 브라우저에서 바로 쓰는 사람용 화면(GET /) 포함: 품목명만 넣고 10초 안에 확인 항목·근거 조문·리콜 이력을 본다. 화면은 CLNS Check · CLNS Intelligence · CLNS Ad & Label · CLNS API & MCP 네 축으로 나뉜다.
  • 품목별 무료 체크 페이지(pSEO) 35개: /p/ 인덱스와 /p/{slug} — 무선 미니 선풍기·보조배터리·오메가3·선크림·반려동물 사료 등. JS 없이 크롤러가 읽는 서버 렌더 HTML에 H1·대표 HS·세관장확인 요건 표·규제 축(소관 기관·확인 카드·MCP 툴)·KC·전파·식약처 항목·핵심 함정·근거·면책·API/MCP 연결 안내·실시간 조회 링크를 담는다(sitemap.xml 동적 생성, 얇은 페이지는 noindex).
  • 익명 일별 통계: GET /v1/stats — IP·User-Agent 원문·쿠키·개인 식별자를 저장하지 않고 날짜별 경로/툴/verdict.code/0건·오류 수만 집계
  • 규제 카드 24개(0.1.5) — 0.1.4의 의료기기법(TRAP-21)·위생용품 관리법(TRAP-22)에 이어, 의약품 반입 카드 2개(TRAP-23 마약류·향정·대마 반입 제한, TRAP-24 6병 기준과 성분 제한의 구분) 를 추가. 마약류·원료물질 목록은 마약류 관리에 관한 법률 시행령 별표 1~8을 법제처 API로 받아 파싱한 로컬 사전(마약류 493건 + 원료물질 55건)으로 대조하고, 미래 시행일 개정 조문은 인용하지 않는다
  • 의약품·성분 체크(한글·영문) — check_drug_import 툴과 웹 화면에서 성분명·제품명(예: 졸피뎀/Zolpidem, Adderall, CBD)을 넣으면 ① 마약류(마약·향정신성의약품·대마 및 합성품) ② 마약류 원료물질(에페드린·슈도에페드린·에르고타민 등) ③ 국내 전용 성분(멜라토닌·DHEA·요힘빈·실데나필 등 시드) 여부와 ④ 자가사용 인정기준(총 6병, 초과 시 용법상 3개월 복용량)을 함께 대조한다. 휴대 반입 소량 일반의약품은 과탐 없이 low_risk, 6병 초과·직구는 check_likely
  • 과대광고·한글표시 검수(0.2.0) — check_ad_labeling 툴과 웹 화면에서 상세페이지 문구와 라벨 문구를 넣으면 품목 유형(일반식품·건강기능식품·화장품·기능성화장품)별 기준으로 질병 효능·의약품 오인·건기식 오인·거짓과장·체험기·비교·비방·보증·기능성 오인·디톡스 표현을 잡고, 근거 법령(식품표시광고법 제8조·화장품법 제13조)·위험도(높음/주의)·대체 표현을 함께 준다. 같은 문구가 유형별로 어떻게 달라지는지 나란히 보여준다
  • 한글표시사항 체크리스트(0.2.0) — 수입식품·건강기능식품·화장품별 필수 표시항목(제품명·원재료명·영업소·소비기한·섭취방법·"건강기능식품" 문자·의약품 아님 표현·전성분·제조번호·가격 등)을 조문 근거와 함께 대조해 누락 항목을 짚는다
  • 식약처 행정처분 연동(0.2.0) — lookup_mfds_disposition 툴로 행정처분결과(식품제조가공업 15124560 · 식품판매업 15124559)를 조회한다. 승인 전파 전·오프라인이면 2026-11-19 스냅샷에서 집계한 업종별 빈발 위반 패턴으로 폴백한다. 원본의 업소명·대표자·연락처·주소·인허가번호는 읽지 않고 버린다
  • 대표 100개 품목 테스트셋(1.0.1 그대로) — 8개 분야(전기·전자 KC / 무선·전파 / 배터리 / 어린이제품 / 식품·건기식 / 화장품 / 생활화학·차량용 방향제 / 의료기기·위생용품) 100건으로 분야별 정확도와 중대 규제 누락(FN) 0건을 검증(--check-testset). 0.1.5에서 의약품 기능을 더해도 이 100건 세트는 손대지 않았고(1.0.1·100건·FN 0 유지), 의약품은 별도 `drug_testset.json` 14건(--check-drugs)으로 관리한다
  • 응답 스키마 0.1.3(0.1.5에서도 유지) — 기존 3단계 verdict 위에 표준 5단계 assessment_status(APPLICABLE·NOT_APPLICABLE·POTENTIALLY_APPLICABLE·REVIEW_REQUIRED·UNKNOWN), missing_information, destination·jurisdiction·origin(ISO), regulation_tags 를 추가
  • MCP 두 가지 전송: HTTP(POST /mcp) + stdio(python -m import_compliance.mcp_stdio) — 로컬 실행형 MCP 디렉터리(Glama·mcp.so 등) 등록용
  • 무료 클라우드 배포 사본 제공: Dockerfile(python:3.12-slim) + render.yaml(Render free Web Service)
  • GitHub Actions CI(.github/workflows/test.yml) — Python 3.11·3.12 에서 --check-corpus + --check-testset + 전체 테스트 자동 실행
  • 라이선스: MIT (LICENSE, Copyright (c) 2026 CLNS-KR)

문서

파일내용
01-api-sources-and-legal.md실제 쓸 공공 API 목록, 신청 방법, 확인한 약관 원문, 상업적 가공 안전성 판정, 2026-11-18 실호출 검증 결과
02-ai-trap-corpus-20.md일반 AI가 틀리는 함정 24개(상황·오답·정답·근거·판정 로직). 파일명은 초기 20건 기준이며, 0.1.5에서 TRAP-23·24를 더해 tools/build_corpus_doc.py로 재생성했다
03-mvp-spec-and-risk-mitigation.md5대 리스크 대응, 아키텍처, 캐시 DB, 8개 툴, 무료/유료 경계, 면책
live-api-verification-2026-11-18.json라이브 검증 산출물(정규화 샘플·상태, 키 없음)
live-scenario-results-2026-11-18.json대표 3품목 라이브 판정 산출물(응답시간·요건·리콜 포함, 키 없음)
09-ad-labeling-0.2.0.md0.2.0 설계 — 유형별 광고 기준 차이, 탐지 규칙 16종, 한글표시 체크리스트, 행정처분 연동·폴백·개인정보 처리
04-live-scenario-report-2026-11-18.md대표 3품목 라이브 판정 사람용 리포트
.env.example키 템플릿(.env는 커밋 금지)
LICENSEMIT 라이선스(Copyright (c) 2026 CLNS-KR)
.github/workflows/test.ymlCI: --check-corpus + --check-testset + 전체 테스트 + stdio MCP 스모크(Python 3.11·3.12)

출시 전 감사·성장 계획(05), 테스트셋·스키마 설계(06), 0.1.4 변경 상세(07), 0.1.5 변경 상세(08), 법령·API 실조회 검증 산출물(medical-hygiene-law-verification.json·drug-law-verification.json·drug-api-verification-2026-11-18.json·ad-label-law-verification.json·food-sanitation-law-verification.json·disposition-api-verification-2026-11-19.json)은 내부 문서로 두고 공개 저장소에는 포함하지 않는다.

실행

cd src

python3 -m import_compliance.cli --check-corpus python3 -m import_compliance.cli --check-testset # 100건 분야별 정확도·규제 누락 FN python3 -m import_compliance.cli --check-drugs # 의약품·영양제 14건(금지성분·자가사용 기준) python3 -m import_compliance.cli --drug 졸피뎀 --channel online --quantity 30 python3 -m import_compliance.cli --drug-schedules # 성분 사전 상태(별표 개정일·건수·미승인 API) python3 -m import_compliance.cli "중국산 블루투스 스피커를 수입해 판매하려고 해" python3 -m import_compliance.cli "150달러 이하 의류 목록통관" python3 -m import_compliance.cli --trap TRAP-15 python3 -m import_compliance.cli --mcp

국표원 리콜 파일데이터 적재·조회(인증키 불필요, 네트워크 필요)

python3 -m import_compliance.cli --fetch-recalls # data/raw CSV + data/recalls.sqlite python3 -m import_compliance.cli --db ../data/recalls.sqlite --recall "전지" python3 -m import_compliance.cli --db ../data/recalls.sqlite --recall-stats

실API 모드 (.env 키 필요)

.env(프로젝트 루트)에 DATA_GO_KR_SERVICE_KEY, LAW_GO_KR_OC를 넣으면 실호출이 켜집니다. .env는 .gitignore에 들어 있고, 코드·문서·로그·응답에는 키가 남지 않습니다.

cd src

python3 tools/verify_live_apis.py --encoding-check # 4개 엔드포인트 라이브 검증 python3 tools/verify_live_apis.py --hs 8507609000 --law-query 관세법 --law-article 226 \ --out ../live-api-verification.json python3 -m import_compliance.cli --live --hs 3307903000 # HS 10자리 세관장확인 실조회 IMPORT_COMPLIANCE_LIVE=1 python3 -m import_compliance.server # HTTP 서버도 live 모드

실API 소스엔드포인트툴에서 보이는 곳
관세청 세관장확인대상물품(15101589)apis.data.go.kr/1220000/retrieveCcctLworCd/getRetrieveCcctLworCdlookup_hs_requirements.hs_requirements_live
식약처 수입식품 허가정보(15058273)apis.data.go.kr/1471000/ImportFoodPrmisnInfoService05/getImrtsCnfirmList05check_food_cosmetics.food_import_live
식약처 수입식품 제품DB(15073949)apis.data.go.kr/1471000/IprtFoodPrdtDBService02/getIprtFoodPrdtDBInq02check_food_cosmetics.food_import_live
법제처 국가법령정보(lawSearch/lawService)www.law.go.kr/DRF/lawSearch.do, lawService.doget_legal_basis.law_live
국립전파연구원 적합성평가 DB정보(3034183)emsit.go.kr/openapi/service/AuthenticationInfoService/getAuthInfo.do (키 불필요)assess_import_case.rra_conformity_live, check_kc_certification.rra_conformity_live
식약처 의약품 계열 5종(15058963·15058041·15095677·15075057·15059486)apis.data.go.kr/1471000/...이 계정은 활용승인 전(코드 30) → drug_screening.api_candidates 에 approval_required 로 표시. 성분 대조는 시행령 별표 로컬 사전으로 수행

HTTP 서버(웹 UI + JSON API + MCP):

cd src

python3 -m import_compliance.server # http://0.0.0.0:8787 · 작업 DB는 ../data/app.sqlite python3 -m import_compliance.server --port 9000 --db /tmp/tck.sqlite curl -s localhost:8787/v1/mcp | head # 툴 매니페스트(사람이 읽는 JSON) curl -s -X POST localhost:8787/v1/tools/assess_import_case \ -H 'Content-Type: application/json' \ -d '{"query":"합성니코틴 액상형 전자담배를 수입해 판매"}'

MCP(JSON-RPC 2.0) — POST /mcp 또는 POST /v1/mcp

curl -s -X POST localhost:8787/mcp -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}' curl -s -X POST localhost:8787/mcp -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"assess_import_case","arguments":{"query":"중국산 무선 선풍기를 수입해 판매"}}}' curl -s localhost:8787/.well-known/mcp/server-card.json | head curl -sI -X OPTIONS localhost:8787/v1/tools/assess_import_case # 204 + CORS curl -s localhost:8787/robots.txt; curl -s localhost:8787/llms.txt; curl -s localhost:8787/sitemap.xml curl -s localhost:8787/p/ | head -40 # 품목별 페이지 인덱스(35개) curl -s localhost:8787/p/usb-mini-fan | head -60 # 품목별 무료 체크(서버 렌더 HTML) curl -s localhost:8787/v1/stats | head -60 # 익명 일별 통계(IP·UA 미저장)

MCP 연결 — HTTP 와 stdio

같은 9개 툴을 두 가지 전송으로 제공합니다(로직은 mcp_http.py 한 곳).

# 1) HTTP(Streamable HTTP · JSON-RPC 2.0, 무인증, application/json 한 덩어리)

POST https://clns-kr.onrender.com/mcp (= /v1/mcp)

2) stdio(로컬 실행형 MCP 디렉터리용) — 한 줄에 JSON-RPC 한 건

cd src python3 -m import_compliance.mcp_stdio \ <<'JSON' {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}} {"jsonrpc":"2.0","id":2,"method":"tools/list"} {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"lookup_hs_requirements","arguments":{"hs_code":"8414519000"}}} JSON

MCP 클라이언트 설정 예시(claude_desktop_config.json 등):

{

"mcpServers": { "clns": { "command": "python", "args": ["-m", "import_compliance.mcp_stdio"], "env": { "PYTHONPATH": "/path/to/clns/src" } } } }

  • stdio 는 stdout 에 JSON-RPC 응답만 쓰고 로그는 stderr 로 보냅니다. notification 에는 아무것도 쓰지 않습니다.
  • 상태를 저장하지 않으므로 initialize 없이 tools/call 을 바로 보내도 동작합니다.
툴 11종
툴하는 일주요 인자
assess_import_case품목·상황 자연어 → 수입요건·인증·표시·통관 함정 3단계 판정 + 근거·면책query(필수), facts, limit
lookup_hs_requirementsHS 10자리 → 세관장확인대상 여부·법령·기관·확인시점hs_code(필수), direction
check_kc_certification전기용품·생활용품·어린이제품·전파 적합성평가 중 걸리는 절차 판정product_name, target_age, rf_tx, battery, ac_plug
check_food_cosmetics식품·건기식·화장품·기구용기: 수입신고·영업등록·한글표시·광고심의product_name, kind(필수)
check_drug_import의약품·영양제 성분 대조: 마약류·원료물질·국내 전용 성분 + 자가사용 인정기준(6병·3개월분)product_name(필수), channel, quantity, unit, prescription, purpose
check_ad_labeling상세페이지·상품명 문구와 라벨 문구를 유형별 기준으로 검수: 위험 표현·근거·대체 표현 + 한글표시사항 누락product_type, ad_copy, label_text, label_items, functional, imported
lookup_mfds_disposition식약처 행정처분 이력(식품제조가공업·식품판매업) + 업종별 빈발 위반 패턴(개인정보 필드 폐기)industry, keyword, license_no, confirmed_on, rows, limit
lookup_recall브랜드·모델명·제품명으로 국내 리콜 이력(국표원 15040696 로컬 인덱스)brand, model, product_name, category
get_legal_basis코퍼스 수록 법령 조항 요지·시행일·원문 URLlaw(필수), article
explain_trap함정 케이스(TRAP-01~24) 시나리오·흔한 오답·정답·근거case_id(필수)
get_service_meta코퍼스 버전·판정 등급·무료/유료 경계·잔여 호출–

무료 한도는 브라우저/클라이언트 ID 당 월 250회이며 get_service_meta 는 차감되지 않습니다.

응답 스키마 0.1.3 — 표준 상태 · 누락 정보 · 공통 필드

기존 3단계 verdict(check_likely/info_needed/low_risk)는 그대로 두고, 판정 상태·빠진 스펙·지리 정보를 추가했다. 필드만 늘었으므로 기존 클라이언트는 수정 없이 동작한다.

필드값설명
assessment_statusAPPLICABLE · NOT_APPLICABLE · POTENTIALLY_APPLICABLE · REVIEW_REQUIRED · UNKNOWN표준 판정 상태(verdict·findings 수·누락 정보에서 계산)
missing_information["hs_10_code", "intended_age", ...]판정을 좁히려면 필요한 표준 스펙명 목록
missing_information_detail[{field, prompt, allowed_values, case_id}]같은 목록의 상세(질문·허용값·케이스)
destination"KR"통관 목적국
jurisdiction"KR"적용 법역(법령 카드가 한국법 기준)
origin"CN" · null원산지 ISO 3166-1 alpha-2. 확인되지 않으면 null(추측하지 않음)
origin_source"query" · "facts" · null원산지를 어디서 확인했는지
regulation_tags["ELECTRICAL_KC", ...]케이스·응답 단위 규제 태그(25종 어휘)
schema_version"0.1.3"응답 스키마 버전

상태와 기존 판정의 대응: check_likely → APPLICABLE(빠진 스펙이 있으면 POTENTIALLY_APPLICABLE), info_needed → REVIEW_REQUIRED, low_risk → NOT_APPLICABLE, 쟁점 0건 → UNKNOWN. 상태·누락 정보는 판정 툴(assess 계열) 응답에 실리고, 나머지 툴은 공통 지리 필드만 갖는다. 실제 판정은 인증·통관 확정이 아니므로 verdict.determinative 는 항상 false 다.

{

"schema_version": "0.1.3", "destination": "KR", "jurisdiction": "KR", "origin": "CN", "origin_source": "query", "verdict": {"code": "check_likely", "label_ko": "확인 대상 가능성 높음", "determinative": false}, "assess

Only the beginning is shown; read the rest in the repo