韩国法律 ALIO MCP

这是一个用于搜索、比较和分析国家法律信息中心与 ALIO 公共机构内部规定的 MCP。

由法制处 87 个工具 + ALIO 公共机构规定 23 个工具，共计 110 个 MCP 工具进行分析。

它搜索 1,600 部法律、10,000 条行政规则、数万件判例以及 344 个公共机构的 35,000 条内部规定，并将比较和分析结果提供给 AI，以帮助生成高质量的回答。

本项目衍生自 chrisryugj/korean-law-mcp。

English

开发初衷

在 korean-law-mcp 的帮助下，处理整体法律法规对公共机构的业务处理大有裨益。再次感谢 chrisryugj。

我认为如果能在此基础上利用公共机构的内部规定，效果会更好。因此，我参考了 ALIO 的公共机构内部规定数据进行了追加开发。

希望本项目能为那些难以接触法律的人们以及全国各地为管理内部规定而苦恼的公共机构员工提供帮助。

v1.0.0 — 同时整合公共机构规定与法制处法令

在原版 87 个法制处工具的基础上，整合了 ALIO 公共机构 23 个工具 + 连接两个领域的 3 个联动工具 — 共 110 个工具，以自然语言搜索、比较和分析 1.27GB 的数据（法制处 + 35,000 条公共机构内部规定）。

追加开发事项

• ALIO 23 个工具 — 整合 344 个公共机构的 35,000 条内部规定（通过 kordoc 整合解析器自动转换 HWP/HWPX/PDF/XLSX，按需读取磁盘）

• 连接公共机构规定与法制处法令的 3 种联动工具

  • 自动提取公共机构规定中引用的上位法 + 从法制处自动查询各法令信息

  • 输入法制处法令，即可在全国范围内反向搜索以该法令为依据的公共机构规定

  • 自动分析单一规定内条款之间的引用与参照关系

• 自然语言路由 — 自动查找正式机构名称（同步加载 institutions.json），自动分流至两个领域

• API 密钥认证失败明确引导 — 整合 12 个 fetch 站点，在 IP/域名白名单拦截时提供注册页面引导

• 设置向导 — npx korean-law-alio-mcp setup（API 密钥 → 运行模式 → 多客户端选择 → 自动注册设置）

• fly.io 远程部署 — https://korean-law-alio-mcp.fly.dev（110 个工具 + ALIO 数据镜像，尽力更新）

• CLI 界面整理 — list/help/--category/explain/REPL + 自然语言 bare-query

• 168 个测试套件 — build 6 + router 13 + cli 23 + alio 39 + law 87 (npm test)

• 许可证卫生 — 4 个文件重写，BSL/Source-Available 代码为 0

示例 — 连接两个领域的自然语言查询

"OO진흥원 인사규정과 관련된 상위 법령을 알려줘"

→ 当 AI 收到自然语言查询时，自动执行以下操作：

• 分析该机构人事规定正文，自动提取引用的上位法

• 从法制处 OpenAPI 自动查询并附加提取出的各法令标识符

• 同时匹配同一机构的内部上位规定

结果示例：

"在人事规定正文中找到了约 10 条上位法引用（例如：人事·劳动相关一般法令、安全·保健相关法令、性别平等相关法令等）。已附加各法令标识符以便后续查询。同时匹配了同一机构的内部上位规定。"

"OO공단의 OOO지침이 근로기준법을 준수하는지 검토해줘"

→ 当 AI 收到自然语言查询时，自动执行以下操作：

• 在 35,000 条公共机构规定正文中反向搜索该法令（例如：劳动基准法）的引用位置

• 整理匹配指南的引用上下文（引用了哪些条款，如何引用）

• 按机构分组显示

结果示例：

"在多个公共机构指南中检测到了该法令的引用案例。通过比较各指南引用条款的方式，可以审查自身机构指南的合规水平。"

在公共机构合规审查、审计、政策分析中，一次性追踪至上位法。

安装与使用方法

第 0 步：申请 API 密钥（免费，1 分钟）

请先申请所有方法通用的 法制处 Open API 认证密钥(OC)。

1. 访问 法制处 Open API 申请页面

2. 注册并登录

3. 点击“Open API 使用申请”按钮

4. 填写申请表 → 发放 认证密钥(OC)（电子邮件 ID 格式）

下面所有示例中的 your-api-key-here 为占位符 — 请替换为您申请的密钥。（与 .env.example 约定相同）

方法 1：Claude Code 插件 — 一行安装

如果先将自己的 API 密钥导出为环境变量，安装时会自动注入。

export LAW_OC=your-api-key-here   # ~/.zshrc 또는 ~/.bashrc 에 추가하면 영구 적용

之后在 Claude Code 中：

/plugin marketplace add scvcoder/korean-law-alio-mcp
/plugin install korean-law-alio@korean-law-alio-marketplace

安装后会自动执行 npx -y korean-law-alio-mcp 并传递 LAW_OC。无需编辑单独的配置文件。

方法 2：在 Claude.ai 网页直接使用（无需安装）最简便

在 claude.ai 中添加自定义连接器。需要 Claude Pro/Max/Team/Enterprise 套餐（免费版仅支持 1 个连接器）。

添加连接器方法：

1. 登录 claude.ai

2. 侧边栏底部点击个人名称 → “设置” → “连接器”

3. “自定义连接器”区域 → “添加自定义连接器”

4. 输入以下内容（将 your-api-key-here 替换为您的密钥）：

   • 名称: korean-law-alio (随意)

   • URL: https://korean-law-alio-mcp.fly.dev/mcp?oc=your-api-key-here

5. “添加” → 注册完成

激活工具（重要）：点击已注册连接器的“配置” → 在工具列表中将 所有工具设置为“始终使用”。AI 无需每次确认即可直接调用。

现在可以在聊天中使用自然语言：

"근로기준법 제74조 알려줘"                              → 법제처 87개 도구
"○○진흥원 인사규정 알려줘"                              → ALIO 23개 도구
"○○진흥원 감사규정과 관련된 상위법령은 뭐니?"          → 규정→법령 연계
"근로기준법과 OO공단의 인사규정의 관계는 어떻게 되니?"  → 법령→규정 역검색
"공공기관 휴직 규정 비교해줘"                            → ALIO 기관간 토픽 비교

ALIO 数据由运营者定期更新，但由于 ALIO 不提供单独的 API，难以保持实时最新（计划定期更新）。

方法 3：在 AI 桌面应用中使用（Claude Desktop · Cursor · Windsurf）

在配置文件中添加以下内容：

{
  "mcpServers": {
    "korean-law-alio": {
      "url": "https://korean-law-alio-mcp.fly.dev/mcp?oc=your-api-key-here"
    }
  }
}

配置文件位置：

如果已经设置了其他 MCP 服务器，只需在 "mcpServers": { ... } 中添加 "korean-law-alio": { ... } 部分。保存后重启应用。

方法 4：直接安装在本地电脑（支持离线）

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

准备工作： Node.js 20 版本以上。

自动安装（推荐）：

npx korean-law-alio-mcp setup

安装向导将一次性处理 API 密钥输入 → AI 客户端选择 → 配置文件自动注册。 支持 Claude Desktop, Claude Code, Cursor, VS Code, Windsurf。

手动安装：

npm install -g korean-law-alio-mcp

在 AI 应用配置文件中添加以下内容（将 your-api-key-here 替换为您的认证密钥）：

{
  "mcpServers": {
    "korean-law-alio": {
      "command": "korean-law-alio-mcp",
      "env": {
        "LAW_OC": "your-api-key-here"
      }
    }
  }
}

准备 ALIO 数据 — 要在本地 PC 上使用 ALIO 工具，必须有数据。请通过以下两种方法之一准备。

(方法 1) 使用运营者镜像（5-15 分钟，推荐）

下载预先收集的数据。约 200MB 压缩包 → 解压后 1.27GB。

Mac, Linux:

curl -L -o alio-data.tar.gz https://github.com/scvcoder/korean-law-alio-mcp/releases/latest/download/alio-data.tar.gz
tar -xzf alio-data.tar.gz -C data/

Windows (PowerShell):

Invoke-WebRequest -Uri https://github.com/scvcoder/korean-law-alio-mcp/releases/latest/download/alio-data.zip -OutFile alio-data.zip
Expand-Archive -Path alio-data.zip -DestinationPath data\

(方法 2) 自行收集（6-12 小时）

从 ALIO 公示中直接收集 344 个公共机构的 35,000 条规定。您可以自行控制最新数据。

建议安装 OS 系统工具以转换扫描 PDF · HWP 3.0 等特殊案例（没有也可以正常处理一般案例，仅跳过特殊案例）。

HWP/HWPX/PDF 整合解析器(kordoc)在 npm install 时会自动安装。无需单独安装，kordoc 难以解析的部分会使用 docling · tesseract · tesseract-lang · libreoffice 进行额外解析。

macOS:

brew install docling tesseract tesseract-lang libreoffice

Linux (Ubuntu/Debian):

sudo apt install tesseract-ocr tesseract-ocr-kor libreoffice
pip install docling

Windows: 仅有 Node.js 即可运行收集（跳过特殊案例）。 如果没有 Node.js，请从 nodejs.org 下载 LTS 版本(20 以上) .msi 安装。

安装完解析所需程序后，使用以下命令收集。

收集命令：

npm run alio:sync                   # 전체 344개 기관 (6-12시간)
npm run alio:sync -- --only C0xxx   # 단일 기관만 (apbaId 4자리, 수 분)
npm run alio:sync -- --resume       # 실패한 기관만 재시도

收集的数据保存在 data/alio/ 中（约 1.27GB）。

重启应用即完成！

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

如果是开发者，可以直接在终端搜索法令·公共机构规定。

# 설치
npm install -g korean-law-alio-mcp

# 인증키 설정 (your-api-key-here 를 본인 키로 바꾸세요)
export LAW_OC=your-api-key-here     # Mac/Linux
set LAW_OC=your-api-key-here        # Windows CMD
$env:LAW_OC="your-api-key-here"    # Windows PowerShell

# 사용 예시
korean-law-alio "민법 제1조"                                # 법제처 자연어
korean-law-alio "OO진흥원 인사규정"                         # ALIO 자연어
korean-law-alio "OO진흥원 인사규정과 관련된 상위 법령"      # 두 영역 연계
korean-law-alio "공공기관 휴직 규정 비교해줘"                # ALIO 기관간 비교
korean-law-alio search_law --query "관세법"                 # 도구 직접 호출
korean-law-alio list                                        # 전체 110개 도구 목록
korean-law-alio list --category ALIO                        # 카테고리별 (ALIO/판례/법령검색 등)
korean-law-alio help search_law                             # 도구별 도움말
korean-law-alio                                             # REPL (대화형)

ALIO 工具 完全使用用户自然语言 — 不会将比较对象机构固定在环境变量中。像“与 A·B·C 机构比较”、“随机”、“全部”这样自由表达，LLM 会自动调用。

API 密钥传递方法总结

可以通过多种方法传递认证密钥。按优先级从高到低排列：

使用示例

法制处工具 — 法令·判例·解释例

"민법 제1조 알려줘"
→ AI 가 법령 검색 → 해당 조문 자동 조회

"음주운전 처벌 기준"
→ AI 가 관련 법령 + 판례 + 해석례를 자동으로 종합 분석

"근로기준법 제74조 해석례"
→ AI 가 해당 조문 + 정부 해석례를 자동 매칭

ALIO 公共机构规定工具

"OO진흥원 인사규정 보여줘"
→ AI 가 정식 기관명을 자동 매칭 → 해당 기관 규정 목록 표시

"공공기관 휴직 규정 비교해줘"
→ AI 가 수집된 공공기관 전체에서 휴직 관련 규정을 자동 비교

"우리 기관에 없는 동종 기관 규정"
→ AI 가 동종 기관 보유 규정 - 자기 기관 보유 규정 = 벤치마킹 후보 자동 추출

连接法制处与 ALIO 的工具

公共机构内部规定本质上是从上位法制处法令获得授权/依据。连接两个领域的自然语言查询也会自动处理：

"OO진흥원 인사규정과 관련된 상위 법령을 알려줘"
→ AI 가 규정 본문에서 인용된 상위 법령을 자동 추출
   + 법제처에서 각 법령 정보를 자동 조회

"OO공단의 OOO지침이 근로기준법을 준수하는지 검토해줘"
→ AI 가 35,000건 공공기관 규정에서 해당 법령 인용 위치를 역검색
   → 매칭된 지침의 인용 컨텍스트 + 기관별 그룹 표시

工具结构 (110 个)

工具详情（名称·参数·示例）请参考 docs/API.md。

主要特点

• 110 个工具整合 — 法制处 87 + ALIO 公共机构 23

• 两个领域联动 — 自动提取公共机构规定引用的法令 + 基于上位法的 ALIO 反向搜索 + 条款间引用图谱

• 自然语言路由 — 自动匹配正式机构名称（已收集 344 个机构），自动分流两个领域

• MCP + CLI — 在 Claude Desktop·Cursor·Windsurf 中，以及终端中均使用相同工具

• 法律领域特化 — 自动识别简称（化管法 → 化学物质管理法），条款编号转换（第38条 ↔ 003800），可视化授权结构

• 表格·附件正文提取 — 自动转换 HWPX·HWP·PDF·XLSX·DOCX（kordoc 引擎）

• 远程 + 本地模式 — 立即使用 https://korean-law-alio-mcp.fly.dev 或在本地 PC 保管数据 (npm run alio:sync)

• 自动安装向导 — npx korean-law-alio-mcp setup

• 验证 — 168 个案例自动测试 (npm test — 构建·路由·CLI·ALIO·法制处)

• 许可证 — MIT

环境变量

全部变量 + 示例请参考 .env.example。

文档

致谢

本项目得以实现，离不开以下人士的贡献：

• chrisryugj — 如果没有您创建的 korean-law-mcp 和 kordoc 项目，本项目将无法启动。衷心感谢。

• jkg — 感谢您提出整合 ALIO 公共机构内部规定的想法。

许可证

MIT

Made by scvcoder