使用说明
🏛️ 韩国法律/案例搜索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密钥:
- 国家法令信息中心Open API网站 访问
- 注册和登录会员
- 协作服务 > 应用程序接口 从菜单申请API
- 批准后 验证密钥(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中使用
- Claude Desktop配置文件(
claude_desktop_config.json)修改:
{
"mcpServers": {
"korean-law": {
"command": "python",
"args": ["-m", "src.law_main"],
"env": {
"LAW_API_KEY": "your_api_key_here"
}
}
}
}
-
重新启动Claude Desktop
-
问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)不再维护。
请使用新的存储库获取最新功能和更新。