⚖️ LexGuard MCP (법실마리)

将韩国法令·判例·法令解释以AI易于理解的形式连接的MCP服务器

基于国家法令信息中心(Open Law)官方数据，将法令·条文·判例·法令解释·行政审判·宪法裁判决定以一个提问流程提供。

• 运行方式：使用本人的国家法令信息中心API密钥直接运行的self-host MCP服务器（无单独托管服务）

• GitHub：https://github.com/SeoNaRu/lexguard-mcp

快速开始（5分钟）

1. 获取API密钥 — 在open.law.go.kr免费申请。申请时必须登记本人IP（参见下方API Key申请）

2. 运行服务器

   git clone https://github.com/SeoNaRu/lexguard-mcp
   cd lexguard-mcp
   cp .env.example .env        # LAW_API_KEY=발급키 설정
   docker compose up --build   # 또는: pip install -r requirements.txt && python -m src.main

3. 连接客户端 — MCP URL：http://localhost:9099/mcp

   • Cursor：将examples/cursor-mcp.local.json内容合并到.cursor/mcp.json

   • Claude Desktop：将examples/claude-desktop-mcp.local.json合并到claude_desktop_config.json的mcpServers中（需要Node.js）

面向市场·爬虫的静态元数据：mcp/manifest.json · 提示词索引 prompts/ · 资源URI指南 resources/README.md · Cursor开发技能 .cursor/skills/lexguard-mcp-dev/SKILL.md

为什么选择LexGuard？

法律在需要时总是显得遥远而困难。 高昂的成本、陌生的术语、不知从何找起的结构。

LexGuard MCP(법실마리) 正是从这一问题出发。

• 用户以人的语言提问

• AI分析提问意图后

• 以官方法令·判例数据为依据提供线索。

不代替判断或法律咨询。 但目标是让初次接触法律的瞬间不再那么困难。

Related MCP server: LexLink

核心功能

MCP工具

legal_qa_tool — 通用法律QA

所有法律问题的单一入口。通过一个问题并行搜索并综合法令·判例·解释·委员会决定例。限定来源的搜索（仅判例、仅解释等）可考虑使用各专用工具。

能力

• 10个领域自动分类

• 问题意图(Intent)多重检测及优先级排序

• 法令 → 判例 → 解释 → 委员会并行搜索

• 自然语言时间条件过滤（date_from / date_to自动转换）

输入模式

示例提示词

프리랜서인데 근로자성 인정된 판례 있나요?
최근 3년 부당해고 판례 알려줘
개인정보 유출됐는데 법적으로 어떻게 되나요?
2023다12345 판례 찾아줘

law_article_tool — 法令条文精确查询

当已知法令名和条文号时，直接查询特定条款。如果说legal_qa_tool是"搜索"，那么这个工具就是"精确查询"。

输入模式

示例提示词

근로기준법 제50조 내용 알려줘
민법 제750조 3항이 뭐야?
개인정보보호법 제17조

law_comparison_tool — 法令新旧·沿革·三段比较

以法令名为基准查询新旧法对比、沿革、三段比较结果。条文原文查询请使用law_article_tool，一般问题请使用legal_qa_tool。

输入模式

示例提示词

근로기준법 신구법 비교 보여줘
민법 연혁 조회

document_issue_tool — 合同·条款分析

粘贴文档后按条款单位提取法律问题，并自动搜索相关法令·判例。

输入模式

支持的文档类型

• labor — 劳动合同 / 劳务合同

• lease — 租赁合同

• terms — 使用条款

示例提示词

이 프리랜서 계약서 문제 있는지 봐줘
아래 임대차 계약서에서 불리한 조항 찾아줘

health — 服务器状态确认

确认MCP服务器运行状态、API Key设置状态、环境变量。

专用搜索工具（限定来源）

当需要查找特定数据而非综合搜索(legal_qa_tool)时使用。

扩展查询工具

需要法令附加信息、沿革、格式、关联等深入查询时使用。

ministry_interpretation_tool — 部门别法令解释

搜索39个部门专用法令解释（质疑问答）数据库。如果说interpretation_tool是综合搜索，那么这个工具是仅直接查询特定部门的解释。

支持部门：雇佣劳动部、国土交通部、企划财政部、国税厅、关税厅、教育部、保健福祉部、法务部、法制处、食品医药品安全处、警察厅、消防厅、海洋警察厅等39个机构

law_history_tool — 法令·条文变更沿革

追踪法令何时以及如何被修订。

示例提示词

근로기준법 개정 이력 알려줘
개인정보보호법 제17조 조문 개정 내역

law_info_tool — 法令附加信息

查询英文法令、国际条约、法令体系图、一览、简称等附加信息。

law_form_tool — 附表格式搜索

按格式名或相关法令名搜索法令·行政规则·自治法规的附表格式。

law_link_tool — 法令-自治法规关联查询

确认特定法令关联的条例列表、按主管部门·地方自治团体的关联现状。

MCP提示词

支持prompts/list和prompts/get端点。

MCP资源

支持resources/list和resources/read端点。

URI方案

精选资源（默认提供）

可立即查询劳动基准法、民法、刑法、个人信息保护法、商法、国家公务员法、行政诉讼法等主要法令。

安装

方法1. 本地（Python）

git clone https://github.com/SeoNaRu/lexguard-mcp
cd lexguard-mcp
pip install -r requirements.txt
cp .env.example .env   # LAW_API_KEY 설정
python -m src.main

方法2. Docker Compose（推荐 · 接近一行）

git clone https://github.com/SeoNaRu/lexguard-mcp
cd lexguard-mcp
cp .env.example .env   # LAW_API_KEY 편집
docker compose up --build

浏览器/客户端MCP URL：http://localhost:9099/mcp · 健康检查：http://localhost:9099/health

方法3. Docker（仅run）

docker build -t lexguard-mcp .
docker run -p 9099:9099 -e LAW_API_KEY=your_key lexguard-mcp

客户端连接

服务器在本地运行时，MCP URL为http://localhost:9099/mcp。

Cursor（.cursor/mcp.json）— 与examples/cursor-mcp.local.json文件相同：

{
  "mcpServers": {
    "lexguard-mcp": {
      "url": "http://localhost:9099/mcp"
    }
  }
}

Claude Desktop（claude_desktop_config.json）— 与examples/claude-desktop-mcp.local.json文件相同。Claude Desktop不直接支持本地HTTP URL，因此使用mcp-remote桥接（需要Node.js）：

{
  "mcpServers": {
    "lexguard-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:9099/mcp"]
    }
  }
}

claude.ai网页连接器指南：网页连接器需要公开HTTPS URL，因此无法连接到本地运行的服务器。建议使用Claude Desktop或Cursor。如果必须在网页上使用，请将服务器部署到本人拥有的服务器（固定IP + HTTPS）后，将该IP登记到open.law.go.kr。

API Key申请（必填）

需要国家法令信息中心Open API密钥。申请和使用均免费。

1. 在https://open.law.go.kr注册

2. 申请OPEN API使用 — 此时必须登记发送请求的服务器（本人PC）的IP或域名。law.go.kr仅允许来自已登记IP的请求。

3. 在.env中设置LAW_API_KEY=申请的密钥

动态IP注意：一般家庭线路的IP可能会变化。如果出现"사용자 정보 검증에 실패하였습니다"错误，请在[open.law.go.kr → API인증키관리]中重新登记当前IP。

DRF方案选择

lexguard-mcp固定国家法令信息中心DRF URL的host/path，仅可通过.env选择方案。

LAW_GO_KR_DRF_SCHEME=https

• 允许值：http、https

• 默认值：https

• 在受限的企业网络/防火墙环境中，可能需要按照官方指南示例使用http://www.law.go.kr/DRF/...路径。

此设置是为了按运行环境调整https硬编码在一般环境中可能被偶然掩盖的潜在URL生成问题而提供的选项。

架构

Client (Cursor / Claude)
    │ JSON-RPC 2.0 over SSE
    ▼
FastAPI  (/mcp POST)
    │ Rate Limiting (slowapi, 600 req/min/IP 기본값)
    ▼
MCP Routes  (tools/call · prompts/get · resources/read)
    │
    ▼
Services  (SmartSearchService · SituationGuidanceService)
    │ asyncio.gather (병렬 멀티 API 호출)
    ▼
Repositories  (Law · Precedent · Interpretation · Appeal · Constitutional …)
    │ httpx (동기/비동기 HTTP 클라이언트)
    │ TTLCache (검색 결과 30분 / 실패 5분)
    │ Exponential Backoff Retry
    ▼
국가법령정보센터 DRF API  (159개 엔트리 / 88개 unique target)

搜索管道

질문 입력
    → 판례 번호 패턴 조기 감지 (2023다12345 / 2021헌마123)
    → 도메인 분류 + 의도(Intent) 분석
    → 시간 조건 파싱
    → asyncio.gather 병렬 API 호출
    → Reranker (BM25 + Keyword Hybrid 재정렬)
    → 응답 포매팅

主要技术栈

Development

# 테스트 실행
pytest tests/ -v

# 린트
ruff check src/

# 로컬 서버 (자동 재로드)
RELOAD=true python -m src.main

License

全文以存储库根目录下的 LICENSE 文件为准。

• 使用： 与 MIT 相同，允许研究、个人及商业使用，包括修改、分发和再销售。

• 销售·付费提供时： 单独销售本软件，或将其包含在产品·服务中销售时，必须将版权声明和本许可证文本包含在最终用户接收到的资料（文档、致谢·许可证页面、包元数据等）中。

本说明仅为摘要，法律效力以 LICENSE 原文为准。

Contribution

Issues & PRs are always welcome. 欢迎法律领域数据、搜索质量改进以及新的 MCP 工具创意。

LexGuard MCP — 为您寻找法律信息的线索。 法律虽然困难，但第一条线索可以变得简单。