Law API MCP Korea

法律api mcp韩国

法制处共同利用国家法令信息保护OPEN API CLI+MCP服务器 这是一个Python包。

在保留191个API文档为正本的同时，还提供法令缩写解释、案例综合搜索、AI引用验证功能。

官方发布渠道： 仅限GitHub发布 （不支持PyPI）

______________________________________________________________________

安装

用于公共部署（wheel）：

pip install law_api_mcp_korea-0.1.0-py3-none-any.whl

wheel文件 从下载。

用于本地开发：

uv sync          # 의존성 설치
pip install -e . # 또는 editable 설치

______________________________________________________________________

设置

法制处OPEN API OC（用户电子邮件ID）参数是必需的。

export LAW_API_OC=your_oc_value
# 또는
echo LAW_API_OC=your_oc_value > .env

.env仅本地，不提交到存储库。

______________________________________________________________________

主要功能

法令缩写自动解释

search_current_law, list_apis, search_decisions 等自动将缩写转换为正式法令名称。

화관법  → 화학물질관리법
근기법  → 근로기준법
개보법  → 개인정보 보호법
공정거래법 → 독점규제 및 공정거래에 관한 법률

案例·案例综合搜索（search_decisions)

使用一个工具搜索9个域。支持代码或韩语缩写。

代码简体中文域名 | --- | --- | --- | | prec 判例，最高法院 | detc |宪法法院，宪法法院，宪法法院判决例 | decc 行政审判行政审判判例 | expc |法令解释，权威解释法令解释例 | tt 小心，租税审判租税审判员 | kmst 海审、海洋审判海洋安全审判员 | nlrc 劳动委员会 | acr 权益委员会，国民权益委员会，国民权益委员会 | moleg 法制处法制处法令解释

AI法令引用验证（verify_citations)

从AI生成的法律文本中提取法律引用，并与实际数据库进行对比，标记是否有幻觉。

______________________________________________________________________

快速使用（CLI）

# API 카탈로그 탐색
law-openapi-cli catalog --search 법령해석
law-openapi-cli doc cgmExpcMolegListGuide
law-openapi-cli inspect-api cgmExpcMolegListGuide --view detail --json

# URL 빌드 및 호출
law-openapi-cli build-url cgmExpcMolegListGuide --param query=퇴직 --param display=5
law-openapi-cli call cgmExpcMolegListGuide --param query=퇴직 --param display=5

# 법령 검색
law-openapi-cli search-law 자동차관리법
law-openapi-cli get-law --id 000744 --type JSON

# 법제처 법령해석
law-openapi-cli search-moleg 퇴직
law-openapi-cli get-moleg --id 12345

# 환경 점검 및 예시
law-openapi-cli doctor
law-openapi-cli examples

______________________________________________________________________

运行MCP服务器

law-openapi-mcp --transport stdio
law-openapi-mcp --transport streamable-http   # http://localhost:8000/mcp

Claude桌面设置

{
  "mcpServers": {
    "law-api-mcp-korea": {
      "command": "law-openapi-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "LAW_API_OC": "your_oc_value"
      }
    }
  }
}

______________________________________________________________________

交付界面

CLI子命令

MCP资源

• lawdoc://catalog
• lawdoc://manifest
• lawdoc://verification
• lawdoc://api/{api_name}

MCP工具

______________________________________________________________________

测试

uv run python -m unittest discover -s tests -p "test_*.py"

LAW_API_OC如果没有，实际API smoke测试将自动跳过。 .env 如果文件存在或设置了环境变量，live smoke也会同时运行。

______________________________________________________________________

配置项目

api/docs/                       # 원본 API 문서 정본 (Markdown)
src/law_api_mcp_korea/
  api_docs/                     # 런타임 flat 문서 + 카탈로그 메타데이터
  aliases.py                    # 법령 약어 사전 + NOT_FOUND 마커
  decisions.py                  # 판례·결정례 도메인 매핑
  citations.py                  # 법령 인용 파서 + 검증 마커
  mcp_server.py                 # FastMCP 서버 (11개 도구)
  client.py                     # MOLEG API 클라이언트
tools/sync_api_docs.py          # api/docs/ → api_docs/ 동기화

修改原始文档后，必须执行同步：

python tools/sync_api_docs.py

______________________________________________________________________

API限制/异常

• 查询法令沿革正文: target=lsHistory + HTML 专用。 JSON/XML未保证稳定的结构响应。
• 监查院事前咨询意见书 (baiPvcs：列表/正文 invalid_api_key 处理为错误。
• live sweep标准：内部API总数 191, invalid_api_key 2健固定。

______________________________________________________________________

发行过程

uv run python -m unittest discover -s tests -p "test_*.py"
python -m build --sdist --wheel

• 在clean venv上安装wheel后运行smoke
• GitHub Release创建→ dist/*.whl, dist/*.tar.gz 附件

pip install law_api_mcp_korea-0.1.0-py3-none-any.whl
law-openapi-cli catalog --search 법령해석
law-openapi-cli get-law --id 001571 --type JSON --with-sub-articles
law-openapi-mcp --transport stdio