chrisryugj/korean-law-mcp · 上手攻略

  • 仓库:chrisryugj/korean-law-mcp
  • 链接:https://github.com/chrisryugj/korean-law-mcp
  • 分类:MCP Server / 法律科技
  • 作者:Jay
  • 更新:2026-07-25

这是什么

korean-law-mcp 是一个基于韩国法制处(법제처)Open API 的 MCP(Model Context Protocol)服务器,同时附带 CLI 工具。它将韩国 42 个官方法律 API 压缩为 10 个核心工具,让 AI 助手(Claude Desktop、Cursor、Windsurf、Zed 等)能够实时查询、验证和分析韩国成文法和判例。

核心解决的痛点:AI 法律回答的幻觉问题。 当 LLM 回答"根据民法第750条…"时,它可能捏造根本不存在的条款或编号——verify_citations 能直接用法制处数据库交叉验证每一个法条引用是否真实存在,甚至验证引用的内容标题是否匹配。


快速安装

前置条件

  • Node.js 18+(建议 Node.js 20+)
  • 法制处 Open API 密钥(免费注册):https://open.law.go.kr/LSO/openApi/guideResult.do

MCP Server 模式(推荐,配合 AI 助手使用)

npm install -g korean-law-mcp

配置到 Claude Desktop(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "korean-law": {
      "command": "korean-law-mcp",
      "env": {
        "LAW_OC": "你的法制处API密钥"
      }
    }
  }
}

⚠️ 注意:法制处 API 要求 HTTP Referer 头,服务器会自动注入(可通过 LAW_REFERER 环境变量覆盖)。云端 IP(GCP/AWS/Fly)会触发 law.go.kr 的 JS 安anti-bot 重定向,v4.6.0+ 已内置自动绕过逻辑(最多 3 跳)。

HTTP 模式(直接 API 调用)

npm install -g korean-law-mcp
LAW_OC=你的API密钥 korean-law-mcp --http
# 默认端口 3100,访问 http://localhost:3100/mcp

CLI 模式(终端直接用)

npm install -g korean-law-mcp
export LAW_OC=你的API密钥

# 自然语言查询
korean-law "민법 제1조"
korean-law "음주운전 처벌 기준"
korean-law "광진구 주차장 조례"

# 交互式 REPL
korean-law

Docker 模式(官方推荐生产用法)

生产环境通过 gomdori-mcp 集成宿主运行,官方地址:

https://mcp.gomdori.app/law

核心用法

10 个核心工具(V3_EXPOSED)

工具 功能
search_law 搜索法律条文(支持别名/缩写展开 + 施行预定检测)
get_law_text 获取法条正文(支持历史版本)
get_article_history 查条文历次修订历史
search_precedents 搜索判例(大法院判决、宪法裁判所决定等)
get_precedent_text 获取判例正文
search_ordinance 搜索地方自治法规(条例、规则)
get_ordinance 获取地方自治法规正文
verify_citations LLM 幻觉克星:验证法条引用是否真实存在+内容匹配
legal_research 自然语言综合法律研究(8 种任务模式)
legal_analysis 深度法律分析(判例生死/行法时法/影响图等)

v4.4.0 起,8 个 chain_* 工具合并为 legal_research,4 个杀手功能合并为 legal_analysis;工具列表从 ~15.1KB 缩减至 ~7.2KB,向下兼容。


典型使用场景

场景 1:验证 AI 生成的法律答案是否靠谱

用户问 AI:"根据韩国商法第401条之2第7款可以追究董事责任,对吗?"

→ 调用 verify_citations:
  - 商法第401条之2 → 存在,但第7款不存在(最大第2款)
  - 结果:[NOT_FOUND] 该条款不存在

场景 2:查判例是否还有效力(韩国版 Shepard's)

"2007다27670 这个案子现在还有效吗?"

→ cite_check:反向追踪引用该案的后续判决 + 全文扫描变更/废弃宣言
  - 判例中如出现"전원합의체 판결은 ... 변경하기로 한다" → 标记为 ❌ 已变更

场景 3:行法时法——查某个时点适用哪版法律

"2023年5月10日当时的道路交通法第44条是什么?"

→ applicable_law:
  - 定位 2023-05-10 施行的 MST 版本
  - 拉取当时条文正文
  - 与现行版本 diff
  - 自动提取后续修订中的适用例/经过规定
  - 附行法时法(刑法第1条)理论指引

场景 4:地方条例是否需要修订( ordinance_radar)

korean-law "광진구 주차장 조례"

→ ordinance_radar:
  - 解析条例第1条目的条款,提取所引据的上位法
  - 对比各上位法施行日期 vs 条例施行日期
  - 自动标记:⚠️ Parking场法 2026-06-03 修订 → 条例需审查

场景 5:两时点法律文本对比(time_travel)

"개인정보보호법 2020-01-01 vs 2025-11-01"

→ 自动拉两时点文本,生成条文级 diff:
  - (+) 新增条款
  - (-) 删除条款
  - (△) 修改条款 + 修改前后正文

场景 6:自然语言法律研究(legal_research)

"식품위생법 영업정지 과태료 감경 가능?"

→ legal_research(full_research):
  - 处罚基准表(按次数/金额分类)
  - 处罚条款原文
  - 实际减轻处罚的行政审判案例
  - 相关条款修订历史
  - "可以继续查询"建议

坑与注意

⚠️ API 密钥注册

  • 法制处 Open API 密钥在 https://open.law.go.kr 免费注册
  • IP 白名单必须包含你的服务器出口 IP(Claude.ai 共享出口 IP 可能在 429 范围)
  • v4.6.6 起,握手/initialize 调用已从 rate limit 中排除,但高并发仍需注意

⚠️ 云端 IP 被拦

  • 在 GCP/AWS/Fly.io 等云平台运行时,law.go.kr 会 JS 重定向拦截
  • v4.6.0+ 内置自动绕过(解析 obfuscated URL → token URL,跟随最多 3 跳)
  • 本地/注册 IP 无此问题(no-op)

⚠️ 别名/缩写歧义

  • "化管法" = 化学物质管理法,"化管法施行令"需展开为"化学物质管理法施行令"
  • v4.0.4 起支持部分匹配(如"화관법 제5조"也能自动展开)
  • 但"인공지능법"(人工智能法)不是正式名称的子串,需通过别名注册解决(v4.7.4)

⚠️ 判例正文可能为空

  • 法制处 JSON API 有时返回空正文
  • v4.0.7 起自动从国税厅 taxlaw.nts.go.kr HTML 补全
  • 企业内网环境可通过 LAW_EXTERNAL_HTTPS_PROXY 配置代理

⚠️ 韩国地名/年号在法律语境有歧义

  • 例:"중처법" = 중대재해 처벌법에 관한 법률(重大灾害处罚法)
  • CLI/工具会根据上下文自动消歧,但极度模糊的缩写可能需手动明确

⚠️ 施行预定法律的误导

  • 某法已颁布但尚未施行 → 现行搜索返回 0 结果
  • v4.5.0 起 search_law 自动标注"施行预定"及新/旧名称映射

与同类对比

工具 数据源 LLM 幻觉验证 判例 Citator 行法时法 CLI
korean-law-mcp 法制处官方 API ✅ verify_citations(含内容匹配) ✅ cite_check ✅ applicable_law ✅ 自然语言 REPL
韩国法学院/法 APR 民间整理
Korean Legal BERT 预训练模型
LexisNexis Korea 商业付费 ✅ 人工校对 部分 部分

核心优势:开源 + 官方数据源 + LLM 幻觉验证三合一,目前开源领域无直接竞品。CLI 的自然语言路由做得相当成熟,非法律专业用户也能直接使用。


一句话推荐结论

如果你在韩国从事法律工作(律师、法务、学生)或用 AI 处理韩国法律事务,必装——它是目前最实用的 AI 法律可靠性保障工具,尤其 verify_citationscite_check 能直接避免引用虚假法条或失效判例这类致命错误;即便你不是法律从业者,"这个法条有效吗?"这类简单问题也值得装一个来查。