法律检索 MCP

韩国法制处 42 个 API 整合为 9 个工具。 法律、判例、行政规则、自治法规、条约、解释例（含国税厅）+ LLM 幻觉防止引用验证 + 条款影响关系图 + 时间点比较自动 diff + 这种情况下这样做 — 5 步指南 + 判例有效性确认(Citator) + 行为时法判断，可在 AI 助手或终端中直接使用。

基于韩国法制处 Open API 的 MCP 服务器 + CLI。可在 Claude Desktop, Cursor, Windsurf, Zed, Claude.ai 等环境中直接使用。

English

v4.4.0 — 暴露工具整合 19 个 → 9 个（上下文缩减 52%）

将 MCP 客户端每次会话读取的工具列表(ListTools)从 ~15.1KB 缩减至 ~7.2KB。

• chain_* 8 个 → 合并为 legal_research 一个（task 参数：full_research·law_system·action_basis·dispute_prep·amendment_track·ordinance_compare·procedure_detail·document_review）
• 杀手级功能 4 个(verify_citations·cite_check·applicable_law·impact_map) → 合并为 legal_analysis 一个（mode 参数）
• 向后兼容：通过旧工具名直接调用或通过 execute_tool 调用均可正常工作。仅从工具列表中移除。

v4.3 — 判例有效性确认 + 行为时法判断

“这个判例还有效吗？” + “案件发生时适用的是哪部法律？” — 捕捉法律实务中最危险的两种错误。

1. cite_check — 判例有效性确认（韩国版 Shepard’s Citator）

"2007다27670 还有效吗？"

→ 对引用该案号的后续判例进行正文检索逆向追踪 + 全员合议体后续判决正文精确扫描 → 检测变更/废止声明：

📊 判定：❌ 检测到变更/废止信号 — 2018다248626(判例变更声明，抵触范围变更)
   上下文："…2008年全员合议体判决在与本判决观点抵触的范围内予以变更…"

追踪判决书中使用案件别名（如“以下称‘2008年全员合议体判决’”）而非案号进行变更声明的惯例。阻止将已变更的判例当作仍有效的判例引用。在免费工具中独一无二。

2. applicable_law — 行为时法判断 + 附则过渡规定

"2023.5.10 当时的道路交通法第44条"

→ 确定基准日正在施行的版本(MST) → 获取该时点条文正文 → 与现行法比较 → 自动提取此后修订附则中的适用例·过渡措施 + 提供行为时法(刑法§1)·制裁处分违法行为时法(行政基本法§14③)的法理说明。从结构上防止 LLM 用现行法给出错误答案。

v4.0 — 同时新增 3 项杀手级功能

条款影响关系图 + 时间点比较 + 分步指南。 法务团队、研究人员、实际使用者过去需要花几天查阅手册的工作，现在一次完成。

1. impact_map — 单一条款的连锁效应关系图

"引用民法第103条的判例"

→ 反向搜索大法院判例·宪法法院决定·法令解释·行政审判·自治法规 + 该条款引用的其他法令(正向) + 自动生成 mermaid 关系图代码。可在 claude.ai 中直接可视化。

graph LR
    민법_제103조["⚖️ 民法第103条"] --> P["📚 大法院判例"]
    민법_제103조 --> C["⚖️ 宪法法院决定"]
    민법_제103조 --> O["🏛️ 自治法规"]

2. time_travel — 两个时间点正文自动 diff

"个人信息保护法 2020-01-01 vs 2025-11-01"

→ 自动获取任意两个时间点正在施行的正文，进行按条款的自动 diff：新增(+) / 删除(-) / 变更(△) 分类 + 变更前后正文 + 字数变化量。

3. action_plan — 这种情况下这样做，5 步指南

"没收到保证金"

→ STEP 1 情况诊断(自动识别住宅租赁保护法) → STEP 2 权利/救济手段(判例) → STEP 3 申请机构/期限(行政规则+解释) → STEP 4 所需文件/格式(附表) → STEP 5 陷阱/注意事项(时效·法律援助机构)。按日常口语输入 → 转换为可执行的步骤。

+ v4.2.0 — 法令现行性保护（防止用修订前法令给出错误答案）

search_law 结果添加 [现行] / ⚠️[沿革-过去版本] 标签 + 施行日标注(现行优先排序)，get_law_text 正文头部添加查询基准日 vs 施行日比较标签(即将施行·efYd 过去查询警告)和旧法令名(“(旧法令名: 火灾预防、消防设施设置ㆍ维护及安全管理相关法律…)”)标注。在工具输出阶段即阻止 LLM 将分立·修订后的法令与学习数据中的旧版本混淆。

+ v4.1.0 — 判例检索结构化 + 详细证据自动连接

将判例检索统一整合为结构化核心(searchPrecedentsStructured)。将长自然语言/概念型查询修正为紧凑查询，并按案号→标题→正文搜索顺序进行回退。自动连接顶级判例到 get_precedent_text(默认 2 件/最多 5 件)以提供依据正文，并支持通过 search_decisions(domain="precedent", options.includeText=true) 选择加入。针对多件详细查询合计时后方判例被截断的问题，已通过按件分配正文预算解决。(外部 PR #46 + 后续优化)

+ v4.0.9 — 韩国法制处 API Referer 标头自动注入

应对韩国法制处 OPEN API 拒绝不含 Referer 标头的请求（与 OC 密钥是否有效无关）并返回“用户信息验证失败”的问题。对 law.go.kr 系列主机的调用自动注入默认 Referer(可通过 LAW_REFERER 覆盖)。该问题曾容易被误认为是 IP/域名注册问题，实际上是易混淆症状的根本原因 — 解决了即使已完成 IP 注册所有搜索仍失败的情况。(外部 PR #45)

+ v4.0.8 — 韩国法制处空白/HTML 响应自动重试

应对韩国法制处 OPEN API 偶尔在 200 状态下返回空白正文或 HTML 检查页面的问题。此前 XML 解析器会因 missing root element 报错并导致“时好时坏”的症状。fetchWithRetry 现在将空白/HTML 响应视为临时故障并进行自动重试(指数退避)，若重试耗尽后仍为空白响应，search_law 将返回明确提示信息而非 missing root element。(与 IP 注册·OC 密钥无关的外部响应不稳定问题)

+ v4.0.7 — 国税厅判例正文 fallback

针对韩国法制处 JSON API 返回空正文的判例，自动从国税厅 taxlaw.nts.go.kr 以 HTML 形式进行补充。JSON 失败、解析失败、正文缺失三种情况均进入 fallback 并安全回收。支持内网/SSL inspection 环境下的 LAW_EXTERNAL_HTTPS_PROXY(可选)·LAW_EXTERNAL_TLS_REJECT_UNAUTHORIZED(诊断用) — 详细设置请参考下方“国税厅判例服务器 TLS/代理设置”部分。(外部 PR #44)

+ v4.0.6 — 韩国法制处 API 协议设置 + 判例重新检索改进

为封闭网络/证书问题环境新增 LAW_API_PROTOCOL=http 选项(默认 https)。改进了判例重新检索关键词候选生成，提高匹配率。(外部 PR #41/#42)

+ v4.0.5 — 依赖项安全漏洞批量修复 (Security)

npm audit 中的 4 项 High 漏洞(@xmldom/xmldom 的 5 项 XML injection + DoS、@hono/node-server 路径绕过、express-rate-limit IPv6 绕过、fast-uri path traversal)已批量修复。均为无 semver-major 变更的 patch/minor 更新。npm audit → 0 vulnerabilities。代码变更为 0。详细的 GHSA 列表请参考 CHANGELOG。

+ v4.0.4 — 缩写部分匹配

原有的缩写处理仅在查询与注册缩写完全匹配时生效(“화관법” → “화학물질관리법”)。v4.0.4 将对缩写与其他词元结合的查询自动扩展为全称变体。

"화관법 시행령"      → "화학물질관리법 시행령"
"화관법 제5조"       → "화학물질관리법 제5조"
"산안법 시행규칙"    → "산업안전보건법 시행규칙"
"중처법 제4조 책임자" → "중대재해 처벌 등에 관한 법률 제4조 책임자"

新增 extractEmbeddedAliases + 整合 expandLawQuery/expandOrdinanceQuery。回归测试 0 项。

v3.5 — 捕捉 AI 法律回答中的幻觉

实时检测 LLM 编造的虚假条款。 通过韩国法制处官方数据库交叉验证所有引用。

"依据民法第750条请求不法行为损害赔偿，
 劳动基准法第60条第1项规定带薪年休假，
 根据商法第401条之2第7项追究董事责任，
 刑法第9999条规定加重处罚"

→ 通过一次 verify_citations（实际韩国法制处 API 交叉验证结果）：

• ✓ 民法第750条(不法行为的内容) 存在
• ✓ 劳动基准法第60条(带薪年休假) 第1项 存在
• ✗ 商法第401条之2 — 无第7项（最大至第2项）
• ✗ 刑法第9999条 — 无对应条款（存在范围：第1条~第372条）

不要轻易相信 ChatGPT·Claude 撰写的法律答案。 法律 AI 服务、律师事务所、学生、合同审查中，可靠性检查必不可少。

v3.2.0+ — 自然语言复合分析

使用方法不变。直接用自然语言提问即可。 AI 会理解问题，并自动添加所需的分析。

被罚款了，能减免吗？

"食品卫生法停业罚款能否减免？"

→ 违规类型处罚基准表 (1次·2次·3次金额) + 罚则条款原文 + 实际被减免的行政审判案例 + 相关条款修订历史一次性呈现。

想进口这个东西，法律上要确认什么？

"进口通关 FTA 适用确认"

→ 关税法 + 关税厅有权解释 + FTA 条约原文 + 税率附表 + 关税纠纷时的税务审判院裁决。以前需要分别查阅韩国法制处、关税厅、税务审判院、外交部四个地方。

建筑许可办理，从哪开始？

"建筑法许可程序"

→ 法律依据 (法律→施行令→施行规则) + 手续费·格式 + 相关训令·例规·告示 + 当地自治条例特则 + 有权解释一站式获取。

修改一部法律，还需要一起改什么？

"建筑法影响分析"

→ 下位法令(施行令·施行规则) + 全国自治法规中受影响的部分 + 相关行政规则列表。

这个法律的授权事项，都制定好了吗？

"国民健康保险法授权立法"

→ 找出规定为“由施行令规定”的条款中尚未制定施行令的部分。

这个条例，与上位法冲突吗？

"停车条例上位法合规性"

→ 搜索宪法法院违宪决定 + 行政审判撤销案例中涉及类似条例的案件，并对照上位法依据。

这个条款，什么时候变的？判例又是怎么变化的？

"劳动基准法修订时间线"

→ 新旧对照表 + 条款별 修订历史 + 相关法令的判例·解释例按时间顺序整合。

使用方法不变。 像以前一样用自然语言提问即可。AI 会根据问题自动添加附加分析。

所有结果末尾会提供**“后续可进行的查询”**建议。复制即可直接继续。

使用方法

快速指南

Claude Desktop 配置示例

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/)

{
  "mcpServers": {
    "korean-law": {
      "command": "npx",
      "args": [
        "-y",
        "korean-law-mcp"
      ]
    }
  }
}

环境变量设置（MCP 客户端，OC 密钥自动注册）

{
  "mcpServers": {
    "korean-law": {
      "command": "npx",
      "args": [
        "-y",
        "korean-law-mcp"
      ],
      "env": {
        "LAW_OC": "여기에_법제처_API_OC_키를_입력"
      }
    }
  }
}

LAW_OC 环境变量无需在每个 MCP 客户端都设置。 全局设置后会自动使用系统变量。Mac/Linux 可添加至 shell 配置文件(~/.zshrc, ~/.bashrc等)，Windows 可通过系统属性 > 环境变量设置。

韩国法制处 OC 密钥可通过 www.law.go.kr > OPEN API 免费获取。MCP 客户端未设置时，使用内置社区测试密钥(非商业用途)。

LAW_OC 直接放入 args 会记录在 shell 历史中，务必使用 env。

独立 CLI 使用

安装后可直接在终端使用：

npx korean-law-mcp --search "주차장법 시행령"
npx korean-law-mcp --tool search_precedents "전세 사기"
npx korean-law-mcp --tool verify_citations --citations "민법 제750조, 형법 제9999조"
npx korean-law-mcp --tool legal_analysis --mode "cite_check:2007다27670"

Docker 使用

# 1. 构建 Docker 镜像
docker build -t korean-law-mcp .

# 2. 运行容器（交互模式）
docker run -i --rm -e LAW_OC=your_oc_key_here korean-law-mcp

# 3. Claude Desktop 配置（需包含已构建的镜像）
# claude_desktop_config.json:
{
  "mcpServers": {
    "korean-law": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "LAW_OC", "korean-law-mcp"],
      "env": {
        "LAW_OC": "your_oc_key_here"
      }
    }
  }
}

提供工具

1. search_law — 集成法律检索

法律、施行令、施行规则、行政规则、自治法规、条约统一检索。

• 法律/施行令/施行规则/条约：通过韩国法制处标准 API
• 行政规则(训令·例规·告示·行业标准)：通过韩国法制处行政规则 API
• 自治法规(自治条例·自治规则)：通过韩国法制处自治法规 API
• 条约：通过韩国法制处条约 API

2. search_precedents — 判例检索

• 大法院判例(包括全员合议体·重要判决)
• 宪法法院决定
• 行政审判(中央行政审判委员会·税务审判院)

3. search_interpretations — 解释例检索

• 法令解释(法制处)
• 国税厅解释

4. get_law_text — 法律详细正文

各条款原文（包含修订历史时提供当前版本）。

5. get_precedent_text — 判例详细正文

判例全文（判决要点·当事人·主文·理由等）。

6. legal_research — 复合法律检索（整合 8 个链条）

一个工具覆盖多种复合分析场景。task 参数指定任务类型：

• full_research — 单次搜索所有类别（法律+判例+解释+行政规则+自治法规+条约）
• law_system — 法律体系分析：法律→施行令→施行规则层级结构
• action_basis — 处分依据确认：相关法律+执行令+罚则+标准+解释
• dispute_prep — 纠纷准备分析：相关判例+解释+行政审判案例
• amendment_track — 修订追踪：修订历史+生效日期+过渡措施
• ordinance_compare — 自治法规上位法合规性：条例+上位法+违宪/取消案例
• procedure_detail — 程序确认：法律依据+格式/费用+相关训令/告示
• document_review — 合同/文件审查：基础法律+相关判例+解释+注意事项

7. legal_analysis — 法律分析（整合 4 个杀手级功能）

一个工具覆盖多种分析场景。mode 参数指定分析类型：

• verify_citations — 引用验证：验证特定法律条款是否存在
• cite_check — 判例引用有效性验证(Shepard’s Citator)：该判例是否仍有效
• applicable_law — 行为时法判断：特定时间点适用哪个版本的法律
• impact_map — 条款影响分析：条款被哪些判例/决定引用

8. time_travel — 法律版本 diff

两个不同时间点的法律正文自动比较。

9. action_plan — 分步行动指南

从自然语言问题生成 5 步可执行的行动计划。

环境变量

# 环境变量
export LAW_LOG_LEVEL=info    # 默认 silent（最小输出）
export LAW_LOG_LEVEL=debug   # 详细调试信息

# CLI 中
npx korean-law-mcp --search "도로교통법" --verbose

# MCP 客户端连接时，服务器自动输出以下日志：
# - 使用的工具名称和参数
# - API 请求/响应状态（仅错误）
# - 缓存命中/未命中

export LAW_EXTERNAL_HTTPS_PROXY=http://proxy.company.com:8080

# 默认 false（允许自签名证书），建议改为 true 后检查：
export LAW_EXTERNAL_TLS_REJECT_UNAUTHORIZED=true
# 如果此时出现错误，则视为 SSL inspection 问题
# 恢复为 false 后，如问题持续，则视为代理问题

系统要求

• Node.js 18+ (推荐 20+)
• npm 9+
• 韩国法制处 OPEN API OC 密钥（免费注册）
• 网络连接至 law.go.kr（韩国法制处 API）

Star 历史

贡献

欢迎错误报告、功能请求、Pull Request。 CHANGELOG 参考

许可证

MIT License — 详见 LICENSE

• fetch-with-retry.ts 中注入通用浏览器 UA 默认头 — 调用方代码零改动，一行补丁即可恢复所有工具。可通过 LAW_USER_AGENT 环境变量覆盖。
• 错误消息为 “请注册正确的服务器设备 IP 地址及域名地址”，容易误认为是 IP 白名单拦截 — 实际原因是 UA 验证。
• 使用 https://korean-law-mcp.fly.dev/mcp?oc=... 的 claude.ai 自定义连接器用户立即受影响。v3.5.5 部署后自动恢复。

v3.5.4 — 采纳实际使用反馈：全面引入 NOT_FOUND 明确信号。

用户反馈：“实际使用时，经常找不到答案，AI 自行胡乱回答。找不到时应明确返回值。”

根本原因：部分工具在查询失败时未设置 isError 标志或仅返回 “不存在” → LLM 未检测到失败，生成虚构回答。

• 全面引入 [NOT_FOUND] / [HALLUCINATION_DETECTED] 机器可解析标记 — 所有失败响应中加入可机械检测的前缀，并标准化 “⚠️ LLM 禁止推测/生成” 警告信息。
• verify_citations — failCount > 0 时设置 isError: true。修复了幻觉检测到却被误判为 “验证成功” 的严重错误。
• annex.ts / law-text.ts / article-detail.ts 等 10+ 个文件 — 补全缺失的 isError: true。
• 链式工具部分失败透明化 — 移除 chains.ts 中的静默丢弃模式。失败部分也通过 [NOT_FOUND / FAILED] 标记及原因明确暴露（从 80 字扩展至 200 字）。
• 新增辅助函数 notFoundResponse(message, suggestions?) 确保一致性。

v3.5.3 — verify_citations 实证验证后修复 3 个致命错误。

使用实际法制处 API 测试 5 例 → 发现 3 例假阴性 → 修复根本原因：

• “民法” → “难民法” 部分匹配误匹配 — 原有 chains.ts 中的 findLaws/scoreLawRelevance 已解决该逻辑，但 verify_citations 未重用而是重复实现。提取为公共模块 lib/law-search.ts 供双方重用（消除重复）。
• 圆数字（①②③…）项号解析失败 — 法制处 API 以 "① " 形式返回项号，原有 parseInt(raw.replace(/[^\d]/g, "")) 移除了 Unicode 圆数字导致 NaN。劳动基准法第 60 条第 1 项实际存在却被误判为 “最大第 0 项” → 在 lib/article-parser.ts 中添加 parseHangNumber() 圆数字映射工具。
• 短法令名检索遗漏 — 法制处 lawSearch API 在 display=20 时将 “商法” 排在第 34 位返回。在 apiClient.searchLaw 中添加 display 参数，verify_citations 以 searchDisplay=100 调用。

验证后 5/5 准确判定（上述示例结果即为输出）。

v3.5.2 — kordoc 2.3.0 → 2.4.0 更新（星号/格式解析引擎）

v3.5.1 — 移除 lite/full 配置文件体系（引入 V3_EXPOSED 16 个固定暴露后实际未使用）。从 tool-profiles.ts 中移除 LITE_TOOLS/parseProfile/filterToolsByProfile，健康端点虚假的 profiles 字段 → 替换为准确的 tools: { exposed: 16, total: 92 }。非破坏性变更（?profile=lite 原本也是被忽略的值）

v3.5.0 — 杀手级功能：verify_citations 引用验证 + 关键热修复 + 安全增强

• 新增 verify_citations — 防止 LLM 幻觉。从用户文本中通过正则提取条文引用 + 前 30 字符 lookback 逆向追踪法令名 + 与法制处数据库并行交叉验证。结果：✓（存在）/ ✗（不存在，给出存在范围）/ ⚠（法令名不明确）
• 关键热修复 — v3.4.0 的 full 参数在 12 个领域（税务审判、海关、公平交易委员会、个人信息保护委员会、劳动关系委员会、行政审判、条约、解释等）中因架构缺少字段而被静默忽略。修复后，unified-decisions.ts 在接收到下级处理器响应后，通过 compactLongSections() 后处理统一应用阶梯式压缩。
• 安全高危 2 项 — fetch-with-retry.ts 中超时/网络错误时包含 API 密钥的 URL 泄漏到日志 → 通过 maskSensitiveUrl() 遮蔽 OC=***。trust proxy true → 改为 TRUST_PROXY 环境变量（默认 1），阻止 X-Forwarded-For 伪造绕过速率限制。
• 质量 3 项 — decision-compact.ts 中日期正则边界检查，TAIL 边界 ". " 误报消除，stripRepeatedSummary 结束点精确检测。
• UX — 8 个链式工具描述具体化（LLM 可自主选择链），搜索结果显示 ”💡 下一步：get_law_text(…)” 提示，search_law 自动重试缩写/错别字扩展，query-router 新增 5 种模式，discover_tools 别名匹配 27 项。

v3.4.0 — 判例响应令牌平均减少 74% + get_decision_text 增加 full 参数。

从法规 RAG 角度重新解读判例响应结构：判示事项、判决要旨、主文是规范复用的核心，保留完整；“理由”全文为个案事实罗列，LLM 大多仅消耗后丢弃。利用这种不对称性，对判例/宪法法院/行政审判（precedent/constitutional/admin_appeal）3 个领域应用 阶梯式压缩 + 结构化引用精炼。新增 lib/decision-compact.ts：

• compactBody — 将全文/理由部分压缩为前 800 字 + 省略标记 + 后 400 字。内置判决结束语（~다.、~라 할 것이다.）和句子边界守护。minSave 守护跳过短正文（1300 字以下）。
• densifyLawRefs — 移除引用条文的括号说明（第390条（债务不履行与损害赔偿） → 第390条）。平均减少 40~55%。
• densifyPrecedentRefs — 移除引用判例中的 “宣告”/“判决” + 日期空格压缩（2020. 3. 26. 宣告 2018두56077 判决 → 2020.3.26. 2018두56077）。
• stripRepeatedSummary — 检测并移除法制处 API 在判示/要旨后再次混入正文开头的重复内容。

get_decision_text 新增 full?: boolean 参数。不指定（默认）= 压缩，true= 全文。响应中的 ⋯ 省略 N 字（full=true 查看全文）⋯ 标记起到重新调用提示作用。

实测（实际法制处 API，固定 ID 8 例）：

长决定例（15,000 字以上）减少 80~89% 最为显著。短正文通过 minSave 守护保持原样。质量无损失（判示、要旨、主文始终完整）。

附加：ListTools 载荷也减少 -14%（9,671 → 8,296 字节，344 令牌↓）：chain_* 8 个描述简化，search_decisions/get_decision_text 字段描述中移除 17 个领域的重复标注。

v3.3.1 — 大幅扩展法令简称词典（11 → 52 个，+41）

lexdiff 中发现 “산안기준규칙” 查询在法制处 aiSearch 的关键词部分匹配下幻觉为 国家标准化基本法，因此大幅扩充 resolveLawAlias 的 LAW_ALIAS_ENTRIES。覆盖高频劳动/安全（产业安全法、重大灾害处罚法、劳动基准法等）、个人信息/信息通信（个人信息保护法、信息通信网法）、廉洁/利益冲突（禁止请托法、防止利益冲突法）、公共合同（国家合同法、地方合同法）、房地产/租赁（住宅租赁法、商用租赁法、不动产交易法）、公平交易（公平交易法、分包法、条款法、标识广告法、加盟事业法）、金融（资本市场法、特定金融法、电子金融法）、城市规划（国土规划法、都市开发法）、环境（传染病预防法、大气环境法）、运输（客运法、货运法）、民/刑事程序（民事诉讼法、刑事诉讼法、民事执行法）、社会保险（国民健康保险法、工伤保险法、就业保险法）、通信（电气通信事业法）。api-client.ts/law-parser.ts 已使用 resolveLawAlias，因此 仅添加数据即可自动受益于现有搜索路径。新增 41 个 + 回归 4 个，45/45 测试通过。

v3.3.0 — HTTP 无状态模式切换 + kordoc 2.3.0

远程服务器（korean-law-mcp.fly.dev）因周期性 OOM 被重启导致原有会话 ID 失效，从根本上解决。切换为 MCP 官方无状态模式（sessionIdGenerator: undefined），每个请求创建全新的 Server + Transport，请求结束后立即释放。完全移除内存会话 Map、InMemoryEventStore、空闲清理，消除泄漏源。重启、扩展、部署均无损。GET /mcp·DELETE /mcp 与官方示例一致返回 405。API 密钥通过 AsyncLocalStorage 按请求隔离（防止竞态条件）。

• HTTP 无状态切换 — src/server/http-server.ts（参考：@modelcontextprotocol/sdk/examples/server/simpleStatelessStreamableHttp.js）
• kordoc 2.2.5 → 2.3.0 — 星号/格式解析引擎更新
• 完全移除会话管理代码 — 删除 sessions Map、MAX_SESSIONS、空闲清理 setInterval、InMemoryEventStore、POST/GET/DELETE 分支逻辑（替代 v3.2.3 的 LRU 淘汰方法）

v3.2.3 — HTTP 会话稳定性中间改进。MAX_SESSIONS 100→500 + LRU 淘汰。已被 v3.3.0 的无状态切换取代。

v3.2.2 — 将星号/格式查询工具（get_annexes）加入默认暴露工具。暴露工具数量 14 → 15 个。在查询退款、减轻关键词时增加自动查询星号逻辑。

v3.2.1 — kordoc 2.2.5 更新。

为何创建

大韩民国拥有 1,600 多部现行法律、10,000 多项行政规则，以及涵盖大法院、宪法裁判所、税务审判院、关税厅的庞大判例体系。所有这些都集中在 法制处 这一个网站上，但开发者体验极差。

本项目将整个法令系统封装为 9 个工具，使 AI 助手或脚本可以直接调用。由一位受够了手动搜索法制处数百次的公务员创建。

安装及使用方法

第 0 步：获取 API 密钥 (免费，1分钟)

所有方法共同需要的 法制处 Open API 认证密钥 (OC) 请先获取。

1. 访问 法制处 Open API 申请页面。
2. 注册后登录。
3. 点击 “Open API 使用申请” 按钮。
4. 填写申请表后，认证密钥 (OC) 会发放。 (例如：honggildong)
5. 在以下设置中使用此认证密钥。

方法 1：Claude Code 插件 (一行安装，最简单) ⚡

如果使用 Claude Code，两行即可完成。安装过程中会自动询问 API 密钥。

/plugin marketplace add chrisryugj/korean-law-mcp
/plugin install korean-law@korean-law-marketplace

安装过程中会提示输入 法制处 API 密钥 (输入第 0 步获得的类似 honggildong 的密钥)。将作为敏感信息安全存储。

使用： 用自然语言向 Claude Code 提问，korean-law MCP 工具将自动调用。

"告诉我劳动基准法第 74 条"
"验证民法第 750 条判例"

更新： 新版本发布时，一行即可更新

/plugin marketplace update korean-law-marketplace

内部执行 npx korean-law-mcp@latest，因此始终使用 npm 上发布的最新版本。

故障排除：Permission denied (publickey) 错误

如果安装过程中出现以下错误，表示 Claude Code 安装器尝试通过 SSH 连接 GitHub，但 SSH 密钥未注册 (尤其常见于首次使用 Git 的非开发者/法律实务人员)。

Failed to install: Failed to clone repository: Cloning into
  '/Users/<user>/.claude/plugins/cache/temp_github_<id>'...
  git@github.com: Permission denied (publickey).
  fatal: Could not read from remote repository.

解决方法 (二选一)：

1. 强制使用 HTTPS (最简单，推荐)： 在终端执行一行后重新尝试 /plugin install

   git config --global url."https://github.com/".insteadOf "git@github.com:"

2. 生成 SSH 密钥并在 GitHub 注册： 如果预计会经常通过 SSH 使用 GitHub 账户的其他仓库

   ssh-keygen -t ed25519 -C "your-email@example.com"   # 回车 3 次
   cat ~/.ssh/id_ed25519.pub                            # 复制输出

   将复制的公钥粘贴到 GitHub → Settings → SSH and GPG keys → New SSH key

安装后保留上述 rewrite 设置也无妨 (HTTPS clone 始终可用)。

方法 2：在 Claude.ai 网页上直接使用 (无需安装)

无需安装任何东西，只需输入一个地址即可。需要 Claude Pro/Max/Team/Enterprise 订阅计划 (Free 仅支持 1 个连接器)。

添加连接器方法：

1. 登录 claude.ai。
2. 点击左侧边栏底部的 您的姓名。
3. 选择 “设置” (或 Settings)。
4. 进入 “连接器” (或 Connectors) 菜单。
5. 在 “自定义连接器” 区域点击 “添加自定义连接器” 按钮。
6. 输入以下内容：
   • 名称：korean-law (任意名称均可)
   • URL：粘贴以下地址。将 honggildong 替换为 第 0 步获得的本人认证密钥：

https://korean-law-mcp.fly.dev/mcp?oc=honggildong

7. 点击 添加 按钮完成注册！

启用工具 (重要！)：

8. 点击已添加连接器的 “配置” (或 Configure)。
9. 显示工具列表后，将所有工具设置为 “始终使用” (或 Always allow)。
10. 这样 AI 即可直接搜索法令，无需每次批准。

使用：

11. 返回聊天界面，输入 “告诉我劳动基准法第 74 条” 即可！

注意：要修改连接器 URL，需删除后重新添加。

从 v3 开始无需选择配置文件。9 个工具覆盖 42 个全部 API。 如果之前使用了 ?profile=lite&oc=... 地址，保留原样即可 — 同样正常工作。

方法 3：在 AI 桌面应用中使用 (无需安装)

如果使用 Claude Desktop、Cursor、Windsurf 等 桌面应用，请在配置文件中添加以下内容。

配置文件位置：

Claude Desktop

Claude Desktop 无法直接连接远程 HTTP MCP 服务器，因此通过 mcp-remote 适配器连接。需要 Node.js 18 以上版本 (为了使用 npx)。

{
  "mcpServers": {
    "korean-law": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://korean-law-mcp.fly.dev/mcp?oc=honggildong"
      ]
    }
  }
}

请将 honggildong 替换为本人认证密钥。如果不想安装 Node.js，请使用 方法 4 的本地安装。

Cursor、Windsurf 等 (支持远程 HTTP 的客户端)

{
  "mcpServers": {
    "korean-law": {
      "url": "https://korean-law-mcp.fly.dev/mcp?oc=honggildong"
    }
  }
}

如果已设置其他 MCP 服务器，只需在 "mcpServers": { ... } 内添加 "korean-law": { ... } 部分即可。

保存后 重启 应用，法令工具即可激活。

方法 4：直接安装在本地计算机 (可离线)

如果想在没有互联网的情况下使用，或者不希望经过远程服务器，可以直接安装。

사전 준비: Node.js 18 以上版本必须安装。

자동 설치 (추천):

npx korean-law-mcp setup

安装向导会自动处理 API 密钥输入 → AI 客户端选择 → 配置文件自动注册等一系列操作。 支持 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Gemini CLI。

수동 설치:

npm install -g korean-law-mcp

在 AI 应用配置文件中添加以下内容（请将 honggildong 替换为您的个人认证密钥）：

{
  "mcpServers": {
    "korean-law": {
      "command": "korean-law-mcp",
      "env": {
        "LAW_OC": "honggildong"
      }
    }
  }
}

重启应用即可完成。

方法 5：直接在终端 (CLI) 中使用

如果您是开发者，可以直接在终端中搜索法规。

# 安装
npm install -g korean-law-mcp

# 设置认证密钥（请将 honggildong 替换为您的密钥）
export LAW_OC=honggildong        # Mac/Linux
set LAW_OC=honggildong           # Windows CMD
$env:LAW_OC="honggildong"       # Windows PowerShell

# 使用示例
korean-law "민법 제1조"                    # 直接以自然语言查询
korean-law search_law --query "관세법"     # 直接调用工具
korean-law list                            # 查看全部工具列表
korean-law list --category 판례            # 按类别筛选
korean-law help search_law                 # 查看工具帮助

API 密钥传递方式汇总

可以通过多种方式传递认证密钥。按优先级从高到低依次生效：

法制处 API 协议设置

法制处 API 调用默认使用 HTTPS。在内部网络、封闭网络等证书验证困难的环境中，可以设置 LAW_API_PROTOCOL=http 使用 HTTP 进行调用。

将配置放在 MCP 客户端设置的 env 块中是最明确的方式：

{
  "mcpServers": {
    "korean-law": {
      "command": "korean-law-mcp",
      "env": {
        "LAW_OC": "honggildong",
        "LAW_API_PROTOCOL": "http"
      }
    }
  }
}

也可以在终端直接运行或使用 .env 文件：

export LAW_API_PROTOCOL=http        # Mac/Linux
set LAW_API_PROTOCOL=http           # Windows CMD
$env:LAW_API_PROTOCOL="http"       # Windows PowerShell

LAW_OC=honggildong
LAW_API_PROTOCOL=http

允许的值为 http、https。如果未设置或设置为其他值，则使用 https。

国税厅判例服务器 TLS/代理设置

由于国税厅来源的判例正文有时无法仅通过法制处的 JSON 响应提供，系统内部会额外查询 taxlaw.nts.go.kr 上的国税厅判例服务器。该服务器即使通过 HTTP 访问也会重定向到 HTTPS，因此 LAW_API_PROTOCOL=http 设置与此无关，需要 Node.js 运行时信任 https://taxlaw.nts.go.kr 的证书。

在内网、封闭网络、防火墙或 SSL inspection 代理之后，浏览器可以打开国税厅判例页面，但 Node.js fetch() 可能会因 [EXTERNAL_API_ERROR] fetch failed 而失败。这是因为浏览器和 Node.js 使用的证书存储和代理设置可能不同。

在生产环境中，请先确认 Node.js 的 HTTPS 连接是否正常：

node -e "fetch('https://taxlaw.nts.go.kr/qt/USEQTA002P.do?ntstDcmId=200000000000019303').then(r=>console.log(r.status,r.url)).catch(e=>console.error(e.name,e.message,e.cause))"

如果运营网络无法直连，需要经过独立的 Web 代理，请设置实际的代理服务器地址。当前，此设置适用于国税厅判例正文回退的外部 HTTPS 连接：

LAW_EXTERNAL_HTTPS_PROXY=http://proxy-host:8080

如果在 Windows 上需要注册为系统环境变量，请在管理员权限终端中进行设置。设置完成后，重启 Windows 或 Node.js 进程：

setx LAW_EXTERNAL_HTTPS_PROXY http://proxy-host:8080 /M

如果即使通过代理路径仍然存在内部证书验证问题，可以在此项目的外部 HTTPS 代理路径上临时禁用 TLS 证书验证，仅用于查明原因。请勿在生产环境中长期使用：

setx LAW_EXTERNAL_TLS_REJECT_UNAUTHORIZED 0 /M

诊断后请删除：

reg delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v LAW_EXTERNAL_TLS_REJECT_UNAUTHORIZED /f

使用示例

"告诉我关税法第38条"
→ search_law("관세법") → 获取 MST → get_law_text(mst, jo="003800")

"比较化学品管理法的最新修订"
→ "화관법" → 自动转换为 "화학물질관리법" → compare_old_new(mst)

"劳动基准法第74条的解释案例"
→ search_interpretations("근로기준법 제74조") → get_interpretation_text(id)

"告诉我产业安全保健法附件1的内容"
→ get_annexes(lawName="산업안전보건법 별표1") → 下载 HWPX 文件 → 将表格/文本转换为 Markdown

工具结构（9 个）

v4.4.0 仅暴露 9 个工具（上下文减少 52%）。原有的 8 个 chain_* 工具整合为 legal_research 的 task，4 个杀手级功能整合为 legal_analysis 的 mode。其余专业工具通过 discover_tools → execute_tool 访问，同时保持向后兼容，仍可直接调用原有的工具名称。

legal_research task 共 8 种（原 chain_*）

legal_analysis mode 共 4 种（原杀手级功能）

全部工具详情请参考 docs/API.md。

主要特点

• 42 个 API → 9 个工具 — 法规、判例、行政规则、自治法规、宪法裁判决定、税务审判、关税解释、国税厅解释例、条约、校规/公团/公共机关规定、法律术语
• MCP + CLI — 在 Claude Desktop 和终端中使用相同的工具
• 法律领域专长 — 自动识别简称（화관법 → 화학물질관리법）、条文编号转换（제38조 ↔ 003800）、三阶授权结构可视化
• 附表/附件格式正文提取 — 自动转换 HWPX·HWP·PDF·XLSX·DOCX（基于 kordoc 引擎）
• 8 个链条 + 7 个场景 — 在基础链条上自动添加场景化扩展分析（罚款减免、关税通关、授权立法监督等）
• 17 个领域统一搜索 — 通过单一 search_decisions 即可立即访问判例、宪法裁判、税务审判、公平交易、劳动委员会等
• 缓存 — 搜索缓存 1 小时，条文缓存 24 小时 TTL
• 远程端点 — 无需安装，直接通过 https://korean-law-mcp.fly.dev/mcp 使用

文档

• docs/API.md — 工具参考
• docs/ARCHITECTURE.md — 系统设计
• docs/DEVELOPMENT.md — 开发指南

星标历史

라이선스

MIT

_{Made by 류주임 @ 광진구청 AI동호회 AI.Do}