关于 Korean Law MCP
Korean Law MCP 是基于韩国法制处 Open API 的法律研究服务和命令行工具,面向法律从业者、公务人员及 AI 工作流。它支持检索法规与判例,并可核验法律引用。
主要功能
- 01搜索法律与行政规则
- 02获取法律正文和附表
- 03跨领域搜索判例
- 04核验 AI 答案中的引用
- 05比较不同时间的法律版本
适用场景
- 01查找法规及其条文
- 02检查法律答案中的引用
- 03比较法规在不同时点的版本
- 04研究判例和解释
MCP 相关
它向 MCP 客户端提供韩国法规、判例、行政规则、自治法规、条约、解释及引用分析工具。支持托管远程服务和本地安装。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.gomdori.app/lawclaude mcp add --transport http chrisryugj-korean-law https://mcp.gomdori.app/law{"mcpServers":{"chrisryugj-korean-law":{"type":"http","url":"https://mcp.gomdori.app/law"}}}在 Cursor 中打开{"servers":{"chrisryugj-korean-law":{"type":"http","url":"https://mcp.gomdori.app/law"}}}在 VS Code 中打开{"mcpServers":{"chrisryugj-korean-law":{"type":"http","url":"https://mcp.gomdori.app/law"}}}{"mcpServers":{"chrisryugj-korean-law":{"serverUrl":"https://mcp.gomdori.app/law"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.gomdori.app/law需要授权工具
10| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 要搜索的法规名称(例如 '관세법'、'fta특례법'、'화관법') |
| display | number | 否 | 最大结果数(默认 50——避免短法规名称的精确匹配遗漏) |
详细介绍
Korean Law MCP
法制处 42 个 API 精简为 10 个工具。 可在 AI 助手或终端中直接查询法令、判例、行政规则、自治法规、条约、解释案例(包括国税厅),并验证 AI 答案中的引文。
基于法制处 Open API 的 MCP 服务 + CLI。可直接用于 Claude Desktop、Cursor、Windsurf、Zed、Claude.ai 等。
**立即使用:**在 Claude.ai 连接器中填入 https://mcp.gomdori.app/law?oc=本人的密钥 即可;Claude Code 只需两行插件配置 → 安装与使用方法
VS Code、Cursor 点一下按钮即可连接(无需密钥,使用公共限额;如需使用自己的密钥,在地址末尾添加 ?oc=本人的密钥)。
如果觉得有用,请在 GitHub 点个 ⭐。这有助于其他人找到这个工具。
▶ 点击即可在 YouTube 上播放。
连接到 AI
| 连接到 Claude | 连接到 ChatGPT |
|---|---|
![]() | ![]() |
最近更新
当前版本为 v4.15.14。所有数据均摘自 CHANGELOG 中的实测记录。
| 版本 | 主要变更 | 变化 |
|---|---|---|
| 4.15.14 | 安全:清理依赖漏洞——升级下游 kordoc 至 4.24.8(zod 4)、zod 至 4.6.7,并更新开发工具和下游依赖修复版本 | npm audit 10 项 → 0 项 |
| 4.15.13 | Claude Code 插件连接到公共服务(mcp.gomdori.app/law),而非本地 npx;密钥可选 | 无需安装 |
| 4.15.12 | 将工具间的使用指引(例如,监控多个法令时使用 search_law_bulk)从工具说明移至服务指引(instructions) | 对同一个问题,在 4 个工具中选择的结果不变 |
| 4.15.11 | 为公开的 10 个工具添加面向用户的标题(title·annotations.title):在客户端批准窗口中显示“搜索法令”等标题 | 标题数 0 → 10 |
| 4.15.10 | 查询国税厅法令解释正文:使用搜索结果中的 본문조회ID(ntstDcmId) 调用 get_decision_text(domain="nts"),获取要旨、回复和正文 (#178) | 从仅有列表和链接 → 支持查看正文 |
完整的历史版本记录请参阅 CHANGELOG.md。重要里程碑:
- v4.14.1:查询单条法条从 3.1 秒降至 0.24 秒(快 13 倍);验证 15 条引文,结果从 ✓0 提升至 ✓15
- v4.13.0:监控合规登记簿从调用
search_law98 次降至调用search_law_bulk1~2 次 - v4.4.0:公开工具数从 19 个降至 9 个;工具列表上下文从约 15.1KB 降至约 7.2KB(减少 52%)
- v3.4.0:判例、宪法法院判决、行政审判响应的平均 Token 减少 74%
为什么要做这个项目
韩国有1,600 多部现行法律、10,000 多项行政规则,以及涵盖最高法院、宪法法院、税务审判院和关税厅的庞大判例体系。这些内容都在法制处这一个网站上,但开发者体验却糟糕透顶。
本项目将整个法令体系封装为10 个工具,让 AI 助手或脚本能够直接调用。项目由一位因手动搜索法制处数百次而不堪其扰的公务员创建。
安装与使用方法
已列入官方 MCP 注册表:io.github.chrisryugj/korean-law-mcp
第 0 步:获取 API 密钥(免费,1 分钟)
请先获取法制处 Open API 认证密钥(OC)。本地安装(方法 4、5)必须提供密钥;使用公共服务的方法(1~3)则无需密钥,可使用公共限额。
访问法制处 Open API 申请页面 → 注册并登录 → 点击 “申请使用 Open API” → 填写申请表后获取认证密钥(OC)(例如:honggildong)。请在下方设置中使用此认证密钥。
方法 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 提问("근로기준법 제74조 알려줘"、"민법 제750조 판례 검증해줘"),就会自动调用 korean-law MCP 工具。要更新到新版本,只需一行:
/plugin marketplace update korean-law-marketplace
插件会连接公开服务
https://mcp.gomdori.app/law(无需在电脑上安装任何内容)。密钥通过apikey标头发送。如果不想经过服务端,请使用方法 4进行本地安装。
故障排除:Permission denied (publickey) 错误
如果安装过程中出现 [email protected]: Permission denied (publickey).,说明安装程序尝试通过 SSH 连接 GitHub,但没有 SSH 密钥(首次使用 Git 的非开发人员和法律从业者经常遇到这种情况)。任选一种方式解决:
- 强制改用 HTTPS(最简单,推荐): 执行以下一行命令,然后重新运行
/plugin install。安装后也可以保留此设置(HTTPS clone 始终可用)git config --global url."https://github.com/".insteadOf "[email protected]:" - 生成并注册 SSH 密钥: 如果以后经常需要使用 SSH
将复制的公钥粘贴到 GitHub → Settings → SSH and GPG keys → New SSH keyssh-keygen -t ed25519 -C "[email protected]" # 엔터 3번 cat ~/.ssh/id_ed25519.pub # 출력 복사
方法 2:在 Claude.ai 网页上直接使用(无需安装)
无需安装任何内容,只需输入一个地址。需要 Claude Pro/Max/Team/Enterprise 套餐(Free 仅支持 1 个连接器)。
-
登录 claude.ai → 左侧边栏底部的本人姓名 → 设置(Settings)→ 连接器(Connectors)
-
添加自定义连接器 → 名称填写
korean-law(可任意填写),URL 填写以下地址(将honggildong替换为第 0 步获取的本人认证密钥)https://mcp.gomdori.app/law?oc=honggildong -
点击添加 → 在连接器的配置(Configure)中将所有工具设置为始终允许(Always allow)(无需每次批准,重要)
-
在聊天中输入“근로기준법 제74조 알려줘”
要修改连接器 URL,请先删除再重新添加。无需选择配置档案(10 个工具可覆盖全部 42 个 API),现有的
?profile=lite&oc=...地址也仍然有效。
方法 3:在 AI 桌面应用中使用(无需安装)
如果你正在使用 Claude Desktop、Cursor、Windsurf 等桌面应用,请将以下内容添加到配置文件中。
查找配置文件位置:
| 应用名称 | Windows | Mac |
|---|---|---|
| Claude Desktop | %APPDATA%\Claude\claude_desktop_config.json | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | 项目文件夹中的 .cursor/mcp.json | 项目文件夹中的 .cursor/mcp.json |
| Windsurf | 项目文件夹中的 .windsurf/mcp.json | 项目文件夹中的 .windsurf/mcp.json |
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 服务,只需将
"korean-law": { ... }部分添加到"mcpServers": { ... }中即可。
保存后重启应用,即可启用法令工具。
方法 4:直接安装到自己的电脑上(可离线使用)
如果想在没有互联网的情况下使用,或不想经过远程服务,可以直接安装。
准备工作: 需要安装 Node.js 20.19 或更高版本(推荐 22.12 或更高版本)。
自动安装(推荐):
npx --ignore-scripts --omit=optional korean-law-mcp setup
安装向导会一次性完成输入 API 密钥、选择 AI 客户端以及自动注册配置文件。
支持 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Gemini CLI、Zed、Antigravity。
写入当前文件夹的配置(Claude Code .mcp.json、VS Code .vscode/mcp.json)可能会被提交到 git,因此不会以明文形式写入密钥。
Claude Code 会添加 ${LAW_OC} 引用,因此请在 shell 设置中添加 export LAW_OC=발급받은키;VS Code 会在首次运行时询问密钥。
手动安装:
npm install --ignore-scripts --omit=optional -g korean-law-mcp
将以下内容添加到 AI 应用的配置文件中(将 honggildong 替换为本人认证密钥):
{
"mcpServers": {
"korean-law": {
"command": "korean-law-mcp",
"env": {
"LAW_OC": "honggildong"
}
}
}
}
重启应用即可完成!
方法 5:在终端(CLI)中直接使用
如果你是开发人员,可以在终端中直接搜索法令。
# 설치
npm install --ignore-scripts --omit=optional -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 密钥传递方式汇总
可以通过多种方式传递认证密钥。优先级从上到下依次递减:
| 方式 | 用法 | 适用场景 |
|---|---|---|
| 放入 URL | 地址末尾加上 ?oc=내키 | 在网页客户端中最方便 |
| HTTP 标头 | apikey: 내키 | 通过编程方式接入时 |
| 环境变量 | LAW_OC=내키 | 本地安装(方法 4、5) |
| 工具参数 | apiKey: "내키" | 仅在特定请求中使用其他密钥时 |
如果不提供密钥而使用公开服务(
mcp.gomdori.app/law),则会使用所有无密钥用户共享的服务器密钥额度。提供自己的密钥则不受此额度限制(免费获取:https://open.law.go.kr)。
法制处 API 协议设置
法制处 API 调用默认使用 HTTPS。在企业内网、隔离网络等难以验证证书的环境中,可以设置 LAW_API_PROTOCOL=http,改用 HTTP 调用。允许值为 http 和 https;未设置或设置为其他值时,默认使用 https。最明确的方式是在 MCP 客户端配置的 env 块中添加:
{
"mcpServers": {
"korean-law": {
"command": "korean-law-mcp",
"env": {
"LAW_OC": "honggildong",
"LAW_API_PROTOCOL": "http"
}
}
}
}
也可以设置终端环境变量或 .env 文件(在 LAW_OC=honggildong 下一行添加 LAW_API_PROTOCOL=http):
export LAW_API_PROTOCOL=http # Mac/Linux
set LAW_API_PROTOCOL=http # Windows CMD
$env:LAW_API_PROTOCOL="http" # Windows PowerShell
国税厅判例服务 TLS/代理设置
当法律法规部 JSON 响应中没有国税厅来源的判例正文时,以及查询国税厅法律解释(nts)正文时,始终会访问 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 -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 连接)。请在具有管理员权限的终端中使用 setx 注册 Windows 系统环境变量,设置后重启 Windows 或 Node.js 进程:
LAW_EXTERNAL_HTTPS_PROXY=http://proxy-host:8080
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 변환
即使简称与其他词语连在一起,也会展开后搜索:화관법 시행령 → 화학물질관리법 시행령,중처법 제4조 책임자 → 중대재해 처벌 등에 관한 법률 제4조 책임자。
自然语言复合分析(场景)
用自然语言提问时,会根据问题自动添加相应的补充分析。场景会从查询关键词中自动检测,也可通过 scenario 参数直接指定。
| 这样提问 | 这样的结果 |
|---|---|
| "식품위생법 영업정지 과태료 감경 가능?" | 处罚标准表(第 1、2、3 次金额)+罚则条款+减轻处罚的行政审判案例+修订历史 |
| "수입 통관 FTA 적용 확인" | 关税法+关税厅权威解释+FTA 条约原文+税率附表+税务审判院判决 |
| "건축법 허가 절차" | 法律→施行令→施行规则依据+手续费、表格+训令、预规、公告+条例特别规定+权威解释 |
| "건축법 영향도 분석" | 下位法规+受影响的全国地方自治法规+相关行政规则 |
| "국민건강보험법 위임입법" | “由施行令规定”的条款中尚无施行令的条款 |
| "주차 조례 상위법 적합성" | 宪法法院违宪决定+行政审判撤销案例+上位法依据对照 |
| "근로기준법 개정이력 타임라인" | 新旧对照表+各条文修订历史+按时间顺序整理的判例、解释案例 |
每项结果末尾都会提供**“可继续进行的查询”**建议。
验证与分析功能
| 功能 | 这样提问 | 执行内容 |
|---|---|---|
verify_citations | 粘贴 AI 撰写的法律答复 | 将引用的条文、判例与法律法规部数据库对照:存在 ✓ / 不存在 ✗(指出存在范围)/ 标题不符 [CONTENT_MISMATCH] / 已废止 ⌛ REPEALED |
cite_check | "2007다27670 아직 유효해?" | 在正文中反向追踪引用该案件编号的后续判例,检测全员合议庭判决的变更、废弃声明(“…변경하기로 한다”) |
applicable_law | "2023.5.10 당시 도로교통법 제44조" | 确定基准日的施行版本(MST)→该时点的条文→与现行版本对比→摘录后续修订附则中的适用例、过渡措施。也支持旧法规名称和公告 |
impact_map | "민법 제103조 인용한 판례" | 反向检索判例、宪法法院、解释案例、行政审判、地方自治法规+正向检索引用的法规+mermaid 图表 |
time_travel | "개인정보보호법 2020-01-01 vs 2025-11-01" | 按条文对两个时点的正文进行 diff:新增(+)、删除(-)、变更(△) |
action_plan | "전세금 못 받았어" | 情况诊断→权利与救济手段→申请机构与期限→所需文件与表格→陷阱与注意事项,分 5 个步骤说明 |
ordinance_radar | "광진구 주차장 조례" | 从条例第 1 条(目的)提取上位法依据→对照上位法现行施行日期与条例施行日期→标记需要审查修订的对象 |
verify_citations 的实际结果示例:
"민법 제750조 … 근로기준법 제60조 제1항 … 상법 제401조의2 제7항 … 형법 제9999조"
✓ 민법 제750조(불법행위의 내용) 실존
✓ 근로기준법 제60조(연차 유급휴가) 제1항 실존
✗ 상법 제401조의2 — 제7항 없음 (최대 제2항)
✗ 형법 제9999조 — 해당 조문 없음 (존재 범위: 제1조~제372조)
常用选项
| 要做的事 | 调用 |
|---|---|
| 查看附则(施行日期、过渡措施) | get_law_text(mst, jo="부칙") |
| 查看特定日期的正文 | get_law_text(mst, efYd=기준일):也会将非施行日期(今天、案件日期)修正为当日施行版本 |
| 查看当日施行中的附表 | get_annexes(lawName, date) |
| 同时按判例名称和正文搜索 | search_decisions(domain="precedent", options={search:"both"}) |
| 仅查看长篇行政规则中的部分内容 | get_admin_rule 的 jo:"제9-5조"、chapter:"제9장"、keyword:"해외직접투자"、page:2 |
| 监控多项法规的变更 | execute_tool(tool_name="search_law_bulk"):传入法规名称数组和 previous={법령ID: 직전 MST} 时,仅返回 MST 已变更的法规 |
| 查看判例全文(取消缩略) | get_decision_text(..., full=true) |
工具结构(10 个)
公开的工具共 10 个。8 个 chain_* 通过 legal_research 的 task 使用,4 个分析功能通过 legal_analysis 的 mode 使用。其余专业工具可通过 discover_tools → execute_tool 访问,直接调用原有工具名称也可向下兼容。
| 分类 | 工具 | 说明 |
|---|---|---|
| 研究(1) | legal_research | 多阶段法规研究:选择 8 种 task(见下表) |
| 精细分析(1) | legal_analysis | 验证与分析:选择 4 种 mode(见下表) |
| 法规(3) | search_law | 搜索法规 → 获取 lawId、MST |
get_law_text | 查询条文全文(使用 jo="부칙" 查询附则) | |
get_annexes | 查询附表、表格(金额表、费率表、附件表格;使用 date 查询当日施行版本的附表) | |
| 地方自治法规(1) | ordinance_radar | 条例修订雷达:自动对照上位法依据的修订 |
| 整合(2) | search_decisions | 21 个领域的整合搜索(判例、宪法法院、税务审判、关税、国税厅、雇佣劳动部解释、公平交易委员会、劳动委员会、工伤保险再审、雇佣保险审查、解释案例、行政审判、个人信息保护委员会、国民权益委员会、诉愿审查、校规、公社公团、公共机构、条约、英文法规) |
get_decision_text | 查询 21 个领域的全文 | |
| 元数据(2) | discover_tools | 搜索专业工具(术语、附表、历史、比较等) |
execute_tool | 执行专业工具代理 |
legal_research 8 种任务(旧称 chain_*)
| task | 说明 | 场景扩展 |
|---|---|---|
full_research(默认) | 综合研究(AI 搜索→法令→判例→解释) | customs:关税与通关综合分析 / action_plan:遇到这种情况该怎么办,提供 5 步指南 |
law_system | 法律体系分析(三级对照、授权结构) | delegation:监测授权立法 / impact:影响分析 |
action_basis | 确认行政行为依据(许可、批准、行政处分) | penalty:综合分析行政处分与处罚标准 |
dispute_prep | 争议应对准备(申诉、诉讼、审判) | domain:税务/劳动/隐私/竞争 |
amendment_track | 跟踪修订(新旧条文对照、沿革) | timeline:时间序列时间线 / time_travel:自动对比两个时间点 |
ordinance_compare | 比较条例(上位法→全国条例) | compliance:验证是否符合上位法 |
procedure_detail | 提供程序、费用与表格说明 | manual:公务员办事手册 |
document_review | 分析合同与条款的风险(必须提供 text) | — |
legal_analysis 的 4 种 mode
| mode | 说明 | 必填参数 |
|---|---|---|
verify_citations | 防止大模型产生幻觉:验证引用的条文与判例是否真实存在,以及条文标题是否一致 | text |
cite_check | 核查判例是否仍有效:追溯后续引用,并检测变更与废止(韩国版 Citator) | caseNumber |
applicable_law | 判断行为发生时适用的法律:提取该时点适用版本及附则中的过渡规定。也支持旧法令名称与行政规则(告示) | lawName、date |
impact_map | 条文影响图谱:反向检索引用的判例、解释与自治法规,并生成 mermaid 图 | lawName、jo |
工具详情请参阅 docs/API.md。
主要特点
- 42 个 API → 10 个工具:涵盖法令、判例、行政规则、自治法规、宪法法院裁决、税务审判、关税解释、国税厅解释案例、条约、学则/公团/公共机构规定及法律术语
- MCP + CLI:在 Claude Desktop 和终端中使用相同的工具
- 专为法律领域设计:自动识别简称(
화관법→화학물질관리법),转换条文编号(제38조↔003800),可视化三级授权结构 - 提供现行性提示:在搜索结果中标注
[현행]/⚠️[연혁-과거버전],并列出即将生效的修订与名称变更;已废止法令会附上废止原因及后续整合规定 - 按过去时点原样查询:通过法令 ID 串联各版本,可查询法令名称变更前的历史版本
- 查询失败时不会答复“没有”:查询失败、检查页面及预算超限等情况均通过
[NOT_FOUND]等明确标记区分 - 提取附表/附件表格正文:自动转换 HWPX、HWP、PDF、XLSX、DOCX(使用 kordoc 引擎)
- 8 个链式工作流 + 9 个场景:在基础工作流中自动添加针对具体情况的扩展分析(如减免罚款、关税通关、监测授权立法等)
- 整合搜索 21 个领域:通过一个
search_decisions工具,即可快速访问判例、宪法法院裁决、税务审判、公平交易委员会、劳动委员会等内容 - 缓存:搜索缓存 1 小时,条文缓存 TTL 为 24 小时
- 远程端点:无需安装即可直接使用
https://mcp.gomdori.app/law(继续兼容旧端点korean-law-mcp.fly.dev/mcp)
HTTP 与执行边界设置
- HTTP 默认绑定地址为
MCP_HTTP_HOST=127.0.0.1,代理信任默认值为TRUST_PROXY=false。对外绑定时必须设置MCP_AUTH_TOKEN;只有在有意公开服务时,才设置MCP_ALLOW_UNAUTHENTICATED_REMOTE=1。位于代理之后时,请设置准确的跳数,例如TRUST_PROXY=1。 - 使用浏览器(Web)客户端时,请设置
ALLOWED_ORIGINS。 由于 MCP 规范要求进行 Origin 验证(防范 DNS rebinding),带有Origin请求头的请求只有来自ALLOWED_ORIGINS白名单(以逗号分隔)中的来源才能通过。若ALLOWED_ORIGINS为空,则改用CORS_ORIGIN作为判断依据(若为*,则允许所有来源;否则只允许该来源)。若两者均未设置,则所有浏览器请求都会被拦截,并在启动时显示提示。设置ALLOWED_ORIGINS后,CORS_ORIGIN不会用于判断来源。 - 若
ALLOW_QUERY_API_KEY=0,则无法通过 URL 查询参数(?oc=키)传递 API 密钥。查询参数中的密钥会以明文形式留在代理/边缘访问日志中,因此建议在内网或日志采集环境中使用此设置。通过请求头(apikey、law_oc等)传递仍可正常使用。 - 设置
ACCESS_LOG=1可记录请求日志。为防止查询字符串中的oc=API 密钥泄露,日志只记录路径。 RATE_LIMIT_RPM=0仅关闭按 IP 限流。MCP_MAX_BATCH_CALLS(默认值为 20)、请求正文、上游尝试次数/响应正文及工具响应限制仍然生效。FALLBACK_DAILY_CAP是服务器密钥回退机制的每日总量上限(默认值为 0,即禁用)。- 启动时会将
MCP_MAX_BODY_BYTES、MCP_MAX_UPSTREAM_REQUESTS(默认值为 48)、MCP_MAX_UPSTREAM_BODY_BYTES、MCP_MAX_TOTAL_UPSTREAM_BODY_BYTES、MCP_MAX_TOOL_RESPONSE_CHARS验证为整数;若值无效,服务器将无法启动。仍兼容旧设置MCP_BODY_LIMIT=100kb。 MCP_CHAIN_DEADLINE_MS(默认值为 45 秒):限制单个链式工作流的执行时间。超时后会返回已组装的部分结果,并用标记注明未能获取的部分。- 仅在需要更改法制处调用所使用的默认值时,才设置
LAW_USER_AGENT和LAW_REFERER。 get_batch_articles最多可查询 20 部法令、共 100 条条文。HTTP 连接关闭或 MCP 取消操作会传递至 fetch、重试等待及响应正文读取过程。JSON-RPC 批次中的各项仅共享预算,取消信号彼此独立。- 发布前会删除
build/,并验证实际打包文件及 exports。kordoc实际用于解析附表 PDF/HWP,因此会保留;仅将所需的纯 JavaScript 依赖[email protected]固定为常规依赖。插件、文档和 Docker 安装会通过--omit=optional --ignore-scripts排除 OCR/ML/native 可选依赖。CI 和发布 workflow 会在关闭 script 的情况下安装开发工具的 optional binding 并进行验证,之后按 production 依赖图进行 prune,再运行 PDF 附表 smoke test。评估 transitive scanner 警告时,会将其与实际可达的服务器路径区分开来。
문서
- docs/API.md — 도구 레퍼런스
- docs/ARCHITECTURE.md — 시스템 설계
- docs/DEVELOPMENT.md — 개발 가이드
- CHANGELOG.md: 버전별 변경 내역
자주 묻는 질문
Q. Claude·ChatGPT에서 한국 법령·판례를 검색하려면?
이 MCP 서버를 연결합니다. Claude.ai는 커넥터 주소 https://mcp.gomdori.app/law?oc=본인키 하나면 되고, Claude Desktop·Cursor·Windsurf·Zed는 설치 및 사용법, ChatGPT는 연결 영상을 따르세요.
Q. 무료인가요? MIT 라이선스 오픈소스입니다. 필요한 법제처 Open API 인증키도 무료로 발급됩니다(0단계).
Q. AI가 지어낸 조문·판례를 걸러낼 수 있나요?
legal_analysis(mode="verify_citations")가 답변 속 법령 조문과 판례 번호를 법제처 원문과 대조해 실존 여부와 내용 일치를 확인합니다. 판례가 아직 유효한지는 mode="cite_check"로 봅니다.
Q. 어디까지 조회되나요? 법령, 판례, 행정규칙, 자치법규(조례·규칙), 조약, 법령해석례(국세청 포함)와 별표·서식입니다. 과거 시점 법령과 폐지 법령의 후속 규정도 찾습니다.
Star History
데이터 출처
법령·판례·행정규칙·자치법규·조약·해석례 본문은 법제처 국가법령정보센터 OPEN API (https://open.law.go.kr/)에서 조회합니다. 국세청 해석례는 국세법령정보시스템을 사용합니다.
법적 효력이 필요한 판단에는 반드시 국가법령정보센터 원문을 확인하세요. 이 도구는 조회 결과를 가공·요약할 수 있습니다.
API 인증키(LAW_OC)는 법제처에서 각자 발급받아야 하며, 발급받은 본인만 사용할 수
있습니다.
라이선스
제3자 구현 참조 및 데이터 출처 고지는 NOTICE를 참조하세요.
Made by 류주임 @ 광진구청 AI동호회 AI.Do
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。


