韩国法律判例搜索服务

基于韩国国家法令信息中心Open API的高性能MCP服务器,为AI代理提供实时韩国法律、判例和行政规则搜索与分析功能。

  • by juhyunchoi-mech
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 juhyunchoi2000/korean-law-mcp

使用说明

🏛️ 韩国法律/案例搜索MCP服务器

国家法令信息中心Open API利用的高性能模型上下文协议(MCP)服务器。

AI代理(Claude Desktop、Cursor等)可以实时搜索和分析韩国法令、判例和行政规则。

主要功能

🔍 法令搜索

  • 基于关键字的法令搜索:搜索民法、商法、劳动基准法等多种法令
  • 查询法令详情:查询特定法令的全文(条文)和详细信息
  • 法令基本信息:包括所管部门、发布日期、实施日期、修订信息

检索案例

  • 搜索案例关键字:检索损害赔偿、合同、不当解雇等案例
  • 查询案例详细信息:判决要旨,判决事项,判例全文查询
  • 法院过滤:支持大法院、宪法法院等法院过滤
  • 参考条文/判例:提供相关法律和参考案例信息

📋 搜索行政规则

  • 搜索行政规则:搜索各部门的行政规则
  • 所管部门信息:制定日期、实施日期等详细信息

🚀 性能优化

  • 战略性缓存:24小时缓存法律/案例数据,最大限度地减少API调用
  • 快速响应:基于缓存的即时响应
  • 稳定的运营:错误处理和记录系统

🎯 使用案例

法律专家

  • 审查合同:AI分析合同并自动参考相关法令和判例
  • 法律咨询:立即查询特定事件的相关法律和判例
  • 判例研究:快速搜索类似案例并进行比较分析

企业法律团队

  • 企业合规性:实时查询业务相关法令
  • 劳务管理:搜索劳动基准法等劳动相关法令及判例
  • 诉讼准备:自动收集相关判例和法令

初创企业/开发者

  • 服务法律审查:确认个人信息保护法、电子商务法等相关法令
  • 创建条款和条件:参考相关法律制定条款和条件
  • 法律风险分析:AI分析服务计划书,了解相关法律风险

普通用户

  • 法律咨询:通过AI代理查询基本法律信息
  • 确认权利:搜索消费者权利、租赁权等相关法令和案例
  • 信访准备:收集行政审判、诉讼准备的法律信息

🛠️ 技术堆栈

  • MCP框架:FastMCP
  • 数据验证:Pydantic
  • HTTP客户端请求:
  • XML解析:xml.etree。元素树
  • 缓存:cachetools(24小时TTL)
  • 异步处理:异步
  • 环境:Python dotenv

📦 安装和设置

1)安装依赖性

pip install -r requirements.txt

💡 uv如果使用: uv sync

2)发放API密钥

必须获得国家法律信息中心Open API密钥:

  1. 国家法令信息中心Open API网站 访问
  2. 注册和登录会员
  3. 协作服务 > 应用程序接口 从菜单申请API
  4. 批准后 验证密钥(OC) 获得发放

📌 请参见:API密钥的发放通常是立即批准的,免费提供。

3)设置环境变量

在项目根目录中 .env 创建文件并设置API密钥:

cp env.law.example .env

.env 文件内容:

LAW_API_KEY=your_law_api_key_here
LOG_LEVEL=INFO
PORT=8096

4)运行服务器

python -m src.law_main

或者作为HTTP服务器运行:

python src/law_main.py

🐳 运行Docker

使用Docker轻松运行:

# 이미지 빌드
docker build -t korean-law-mcp:latest .

# 컨테이너 실행
docker run --rm \
  -e LAW_API_KEY=your_law_api_key_here \
  -p 8096:8096 \
  korean-law-mcp:latest

🧰 可用工具(Tools)

1. health

  • 说明:检查服务状态和API密钥设置
  • 参数:无
  • 返还:服务状态对象

2. search_law_tool

  • 说明:搜索法令作为关键字
  • 参数:
    • query (string,必需):要搜索的法令关键字(例如“民法”、“商法”)
    • page (integer,可选):页码(默认值:1)
    • page_size (integer,可选):每页的结果数(默认值:10,最大值:50)
  • 返还:搜索到的法令列表(法令名称、所管部门、公布日期、实施日期等)

示例响应:

{
  "total": 152,
  "page": 1,
  "page_size": 10,
  "laws": [
    {
      "법령ID": "001122",
      "법령명": "민법",
      "법령구분": "법률",
      "소관부처": "법무부",
      "공포일자": "19580222",
      "시행일자": "19600101"
    }
  ]
}

3. get_law_detail_tool

  • 说明:查询特定法令的详细信息和全文(条文)
  • 参数:
    • law_id (string,必需):法令ID(从法令搜索结果中获得的法令ID)
  • 返还:法令的详细信息和所有条文内容

示例响应:

{
  "법령ID": "001122",
  "법령명": "민법",
  "법령구분": "법률",
  "소관부처": "법무부",
  "공포일자": "19580222",
  "시행일자": "19600101",
  "조문수": 1118,
  "조문": [
    {
      "조문번호": "제1조",
      "조문제목": "법원",
      "조문내용": "민사에 관하여 법률에 규정이 없으면..."
    }
  ]
}

4. search_precedent_tool

  • 说明:按关键字搜索案例
  • 参数:
    • query (string,必需):要搜索的案例关键字(例如“损害赔偿”、“合同”)
    • page (integer,可选):页码(默认值:1)
    • page_size (integer,可选):每页的结果数(默认值:10,最大值:50)
    • court (string,可选):区分法院(如“最高法院”、“宪法法院”)
  • 返还:搜索到的案例列表

示例响应:

{
  "total": 2453,
  "page": 1,
  "page_size": 10,
  "precedents": [
    {
      "판례일련번호": "202012345",
      "사건명": "손해배상(기)",
      "사건번호": "2020다123456",
      "선고일자": "20201015",
      "선고": "파기환송",
      "법원명": "대법원",
      "사건종류명": "민사",
      "판시사항": "...",
      "판결요지": "..."
    }
  ]
}

5. get_precedent_detail_tool

  • 说明:查看特定案例的详细信息
  • 参数:
    • precedent_id (string,必需):案例序列号
  • 返还:判例的详细信息(判决要点、参考条文、判例全文等)

示例响应:

{
  "판례일련번호": "202012345",
  "사건명": "손해배상(기)",
  "사건번호": "2020다123456",
  "선고일자": "20201015",
  "선고": "파기환송",
  "법원명": "대법원",
  "판시사항": "...",
  "판결요지": "...",
  "참조조문": "민법 제750조, 제751조",
  "참조판례": "대법원 2019다234567...",
  "판례내용": "【전문】..."
}

6. search_administrative_rule_tool

  • 说明:搜索行政规则作为关键字
  • 参数:
    • query (string,必需):要搜索的行政规则关键字
    • page (integer,可选):页码(默认值:1)
    • page_size (integer,可选):每页的结果数(默认值:10,最大值:50)
  • 返还:搜索到的管理规则列表

💡 使用示例

在Claude Desktop中使用

  1. Claude Desktop配置文件(claude_desktop_config.json)修改:
{
  "mcpServers": {
    "korean-law": {
      "command": "python",
      "args": ["-m", "src.law_main"],
      "env": {
        "LAW_API_KEY": "your_api_key_here"
      }
    }
  }
}
  1. 重新启动Claude Desktop

  2. 问Claude:

    • “告诉我民法第750条。”
    • “帮我找一下不当解雇相关的判例”
    • “帮我搜索个人信息保护法”

在Cursor中使用

在Cursor的MCP设置中,按上述方式添加即可。

📁 项目结构

korean-law-mcp/
├── src/
│   ├── __init__.py
│   ├── law_main.py        # MCP 서버 메인 파일
│   └── law_tools.py       # 법률 API 호출 도구
├── .env                   # 환경 변수 파일 (API 키 등)
├── env.law.example        # 환경 변수 예시 파일
├── requirements.txt       # Python 의존성
├── README_LAW.md          # 프로젝트 문서 (이 파일)
└── pyproject.toml         # 프로젝트 설정

🚀 路线图

  • []查询法令修订历史
  • []下载法律/案例专业PDF
  • []基于自然语言的法令解释
  • []法令比较分析功能
  • []案例相似度分析
  • []法律术语词典

💰 业务模式

这个MCP服务器 销售产品开发为:

目标客户

  • 🏢 律师事务所/律师事务所:自动化法律研究
  • 🏭 企业法律团队:法规遵从性管理
  • 🚀 初创企业:法律风险分析
  • 🎓 法学研究人员:案例研究工具

定价(请参见)

  • 基础:30万韩元(基本搜索功能)
  • 专业版:100万韩元(增加AI分析功能)
  • 企业:200万韩元+(自定义,技术支持)

差别点

  • 利用国家官方数据
  • 直接集成AI代理
  • 实时查看最新法令/判例
  • 韩语完全支持
  • 自动化复杂的API处理

存储库迁移指南(Repository Moved)

本项目反映了更广泛的结构和更明确的目的。
以下存储库 迁移和继续开发正在进行。

👉 LexGuard MCP
https://github.com/SeoNaRu/lexguard-mcp

此存储库(korean-law-mcp)不再维护。
请使用新的存储库获取最新功能和更新。