法律检索 MCP

v3.5.5 — 绕过法制处API机器人拦截（紧急热修复）

法制处OPEN API开始将Node.js默认User-Agent (undici/...)归类为机器人并拒绝 → 导致fly.dev/Vercel等所有云托管出现[EXTERNAL_API_ERROR] fetch failed或XML报错“用户信息验证失败”等崩溃现象。

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

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

用户反馈：“实际使用中经常找不到答案，AI随意回答。找不到时应明确返回值。”

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

• 全面引入[NOT_FOUND] / [HALLUCINATION_DETECTED]机器解析标记 — 所有失败响应均包含可机械检测的前缀 + 标准化警告“⚠️ LLM禁止推测/生成”
• verify_citations — 当failCount > 0时设置isError: true。修复原本幻觉被检测到但仍被误认为“验证成功”的严重Bug
• annex.ts / law-text.ts / article-detail.ts等10+个文件 — 修复isError: true缺失问题
• 链式工具部分失败透明化 — 去除chains.ts中的silent-drop模式。失败部分也明确显示[NOT_FOUND / FAILED]标记及原因（80字符扩展至200字符）
• 新增辅助函数notFoundResponse(message, suggestions?)确保一致性

v3.5.3 — verify_citations实证测试后修复3个致命Bug

使用实际法制处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 — Killer功能：verify_citations引用验证 + 关键热修复 + 安全强化

• 新增verify_citations — 防止LLM幻觉。从用户文本中正则提取条文引用 + 向前30字符回溯法令名 + 并行交叉验证法制处数据库。结果：✓（真实存在）/ ✗（不存在，给出存在范围）/ ⚠（法令名不明确）
• 关键热修复 — v3.4.0的full参数在12个领域（tax_tribunal, customs, ftc, pipc, nlrc, acr, treaty, interpretation等）因架构中缺少字段而被静默忽略的问题已修复。unified-decisions.ts在处理下级处理器响应后，通过compactLongSections()后处理进行层级式缩略统一应用
• 安全High 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个链的description（使LLM能选择链）、搜索结果增加“💡 下一步：get_law_text(…)”提示、search_law的缩写/拼写错误自动重试扩展、query-router新增5种模式、discover_tools增加27个别名匹配

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

从法规RAG角度重新解读判例响应结构：判示事项、判决要旨、主文是规范再利用的核心，因此保持完整；而“理由”全文罗列个案事实关系，LLM大多仅在消费后丢弃。利用这一不对称性，对判例/宪裁/行审（precedent/constitutional/admin_appeal）三个领域应用层级式缩略 + 结构化引用浓缩。新增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 bytes，344 tokens↓）：简化了 chain_* 8 个 description，消除了 search_decisions/get_decision_text 字段 describe 中 17 个域名的重复表述。

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

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

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

原先远程服务器（korean-law-mcp.fly.dev）因周期性 OOM kill 重启导致现有会话 ID 失效的问题得到根本解决。切换至 MCP 官方无状态模式（sessionIdGenerator: undefined），每次请求创建全新的 Server + Transport，请求结束时立即释放。完全移除 in-memory 会话 Map、InMemoryEventStore、idle cleanup，消除泄漏根源。重启、水平扩展、部署均无数据丢失。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、idle cleanup setInterval、InMemoryEventStore、POST/GET/DELETE 分支逻辑（替代 v3.2.3 的 LRU eviction 方案）

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

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

v3.2.1 — 更新 kordoc 2.2.5。

为什么开发

大韩民国拥有 超过 1,600 件现行法律、超过 10,000 件行政规则，以及连接大法院、宪法法院、税务审判院、关税厅的庞大判例体系。所有这些都在 法制处 这一个网站中，但开发者体验极其糟糕。

本项目将整个法令系统封装为 10 个工具，使 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 Key 并注册到 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://mcp.gomdori.app/law?oc=honggildong

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

激活工具 (重要！):

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

使用方法:

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

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

从 v3 版本开始，无需选择配置文件。10个工具覆盖了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://mcp.gomdori.app/law?oc=honggildong"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "korean-law": {
      "url": "https://mcp.gomdori.app/law?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 代理，请设置实际的代理服务器地址。此设置当前适用于国税厅判例正文 fallback 的外部 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

工具结构 (10个)

v4.4.0 整合了公开工具 (上下文缩减 52%)。原有的 8 个 chain_* 整合到 legal_research 的 task 中，4 个杀手级功能整合到 legal_analysis 的 mode 中。其余专有工具通过 discover_tools → execute_tool 访问，同时保留对原有工具名称的直接调用以实现向后兼容。v4.7.0 新增了 ordinance_radar，目前共 10 个。

legal_research 任务 8 种（原 chain_*）

legal_analysis 模式 4 种（原 killer feature）

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

主要特点

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

文档

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

Star History

许可证

MIT

_{Made by 柳主任 @ 广津区厅 AI 同好会 AI.Do}