⚖️ LexGuard MCP (法律线索)

将韩国法律、判例、法律解释以 AI 易于理解的形式连接起来的 MCP 服务器

基于国家法律信息中心 (Open Law) 的官方数据，提供涵盖法律、条款、判例、法律解释、行政审判、宪法法院裁决的单一问答流程。

• MCP Endpoint: https://lexguard-mcp.onrender.com/mcp

• Health Check: https://lexguard-mcp.onrender.com/health

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

快速连接 (复制粘贴)

仅使用远程 MCP 时，可以将以下 JSON 直接放入客户端配置中。

• Cursor: 将 examples/cursor-mcp.remote.json 的内容合并到 .cursor/mcp.json 等文件中

• Claude Desktop: 将 examples/claude-desktop-mcp.remote.json 合并到 claude_desktop_config.json 的 mcpServers 中

单行本地运行 (Docker): 在仓库根目录下执行 docker compose up --build，MCP URL 为 http://localhost:9099/mcp。（API 密钥: LAW_API_KEY=发放的密钥 docker compose up --build）

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

Why LexGuard?

法律在需要时总是显得遥远且晦涩。 高昂的成本、陌生的术语、不知从何查起的结构。

LexGuard MCP (法律线索) 正是从这个问题出发的。

• 用户用人话提问

• AI 分析提问意图后

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

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

Core Features

MCP Tools

legal_qa_tool — 通用法律 QA

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

Capabilities

• 13 个领域自动分类

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

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

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

Input Schema

Example Prompts

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

law_article_tool — 法律条款精确查询

在已知法律名称和条款编号时直接查询特定条款。如果说 legal_qa_tool 是“搜索”，那么该工具就是“精确查询”。

Input Schema

Example Prompts

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

law_comparison_tool — 法律新旧/沿革/三段对比

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

Input Schema

Example Prompts

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

document_issue_tool — 合同/条款分析

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

Input Schema

Supported Document Types

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

• lease — 租赁合同

• terms — 使用条款

Example Prompts

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

health — 服务器状态检查

检查 MCP 服务器运行状态、API Key 设置状态及环境变量。

专用搜索工具 (限定来源)

代替综合搜索 (legal_qa_tool)，在仅查找特定数据时使用。

MCP Prompts

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

MCP Resources

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

URI Scheme

Featured Resources (默认提供)

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

Installation

Method 1. Local (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

Method 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

Method 3. Docker (仅 run)

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

Method 4. Remote MCP (托管 URL)

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lexguard-mcp": {
      "url": "https://lexguard-mcp.onrender.com/mcp"
    }
  }
}

Cursor (.cursor/mcp.json)

与 examples/cursor-mcp.remote.json 文件相同:

{
  "mcpServers": {
    "lexguard-mcp": {
      "url": "https://lexguard-mcp.onrender.com/mcp"
    }
  }
}

API Key 发放

需要国家法律信息中心 Open API 密钥。

1. 访问 https://open.law.go.kr 注册会员

2. 申请 API 使用

3. 在 .env 中设置 LAW_API_KEY=发放的密钥

Architecture

Client (Cursor / Claude)
    │ JSON-RPC 2.0 over SSE
    ▼
FastAPI  (/mcp POST)
    │ Rate Limiting (slowapi, 60 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  (172개 엔드포인트)

搜索流水线

질문 입력
    → 판례 번호 패턴 조기 감지 (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 随时欢迎。 欢迎法律领域数据、搜索质量改进、新的 MCP 工具创意。

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