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_citations和cite_check能直接避免引用虚假法条或失效判例这类致命错误;即便你不是法律从业者,"这个法条有效吗?"这类简单问题也值得装一个来查。