プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

CLNS — Korea Import Compliance

作者:CLNS-KRバージョン 0.2.0i★ 0iクラウドで動く公式サイト ↗
レジストリ名io.github.CLNS-KR/clns

インストール方法

できること

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

作者による原文

  • 接続方法 クラウドで動く
  • アカウントまたはキー キー不要
  • カテゴリ 法律・行政データ

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア20/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

CLNS — Korea Import Compliance をインストールして。https://mcp.popnx.com/i/clns-kr-clns.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(clns-kr.onrender.com)を通ります · ✓ コマンド確認済み 2026年11月18日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前CLNS — Korea Import Compliance
    Remote MCP server URL · アドレスhttps://clns-kr.onrender.com/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsCLNS — Korea Import Compliance

  4. 試してみる

    CLNS — Korea Import Compliance を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が CLNS — Korea Import Compliance を使っていると言うか、回答に CLNS — Korea Import Compliance のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前CLNS — Korea Import Compliance
    Connection · アドレスhttps://clns-kr.onrender.com/mcp
  3. チャットで CLNS — Korea Import Compliance を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から CLNS — Korea Import Compliance を選びます

  4. 試してみる

    CLNS — Korea Import Compliance を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が CLNS — Korea Import Compliance を使っていると言うか、回答に CLNS — Korea Import Compliance のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user clns https://clns-kr.onrender.com/mcp
  3. Claude Code で /mcp と入力

    CLNS — Korea Import Compliance が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    CLNS — Korea Import Compliance を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が CLNS — Korea Import Compliance を使っていると言うか、回答に CLNS — Korea Import Compliance のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    CLNS — Korea Import Compliance を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が CLNS — Korea Import Compliance を使っていると言うか、回答に CLNS — Korea Import Compliance のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    CLNS — Korea Import Compliance を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が CLNS — Korea Import Compliance を使っていると言うか、回答に CLNS — Korea Import Compliance のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://clns-kr.onrender.com/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?CLNS — Korea Import Compliance を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

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"
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
0.2.0
レジストリ公開日i
2026年11月19日
コードの最終更新i
2026年11月19日
最終確認
2026年11月18日
作者
CLNS-KR
ウェブサイト
clns-kr.onrender.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月18日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • 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단계 판정 정의, 무료/유료 경계, 잔여 호출 수를 반환합니다.

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント CLNS-KR で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    393ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    8件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

法律・行政データのほかのサーバーとの比較i

  • このカテゴリのほかの1961件のうち0%よりスターが多い
  • このカテゴリのほかの1961件のうち97%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1961件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

CLNS — Korea Import Complianceは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.2.0)がレジストリに届いたのは昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Global law

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

作者:lexifina広く使われている★ 210510 日前更新

クラウドで動く✓ lexifina.com

LibreJustice

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

作者:librejustice初期★ 382 か月前更新

クラウドで動く✓ 提供元 · librejustice.fr

InfraNode

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

作者:street1983nk初期★ 185 か月前更新

クラウドで動く✓ 提供元 · infranode.dev
似たものと比べる
これ
CLNS — Korea Import Compliance
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック5/54/44/44/44/44/4
ライセンスMITNOASSERTIONMITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。


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

冒頭だけを表示しています。続きはリポジトリで読めます