原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 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 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 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 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 CLNS — Korea Import Compliance,或回答中出现 CLNS — Korea Import Compliance 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

能否连接 ChatGPT 取决于方案

完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页

  1. 在网页版 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 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 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 在列表中并显示已连接

  4. 试一试

    用 CLNS — Korea Import Compliance 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 CLNS — Korea Import Compliance,或回答中出现 CLNS — Korea Import Compliance 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  2. 在 Cursor 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 CLNS — Korea Import Compliance 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 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 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 CLNS — Korea Import Compliance 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 CLNS — Korea Import Compliance,或回答中出现 CLNS — Korea Import Compliance 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

地址https://clns-kr.onrender.com/mcp

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 CLNS — Korea Import Compliance 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

通过网页连接

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
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 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)于昨天进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。

有什么可以替代它?

同一分类中有:Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况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

只显示了开头部分;其余内容请在仓库中阅读