⚖️ LexGuard MCP (Pista Legal)

Un servidor MCP que conecta leyes, jurisprudencia e interpretaciones legales de Corea del Sur en una forma fácil de entender para la IA.

Basado en los datos oficiales del Centro Nacional de Información Jurídica (Open Law), proporciona leyes, artículos, jurisprudencia, interpretaciones legales, apelaciones administrativas y decisiones del Tribunal Constitucional en un único flujo de preguntas.

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

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

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

Conexión rápida (copiar y pegar)

Al usar solo el MCP remoto, puede insertar el siguiente JSON directamente en la configuración de su cliente.

• Cursor: Combine el contenido de examples/cursor-mcp.remote.json en .cursor/mcp.json, etc.

• Claude Desktop: examples/claude-desktop-mcp.remote.json → combinar en mcpServers de claude_desktop_config.json

Ejecución local en una línea (Docker): Después de docker compose up --build en la raíz del repositorio, la URL de MCP es http://localhost:9099/mcp. (Clave API: LAW_API_KEY=clave_emitida docker compose up --build)

Metadatos estáticos para marketplaces/crawlers: mcp/manifest.json · Índice de prompts prompts/ · Guía de URI de recursos resources/README.md · Habilidades de desarrollo de Cursor .cursor/skills/lexguard-mcp-dev/SKILL.md

¿Por qué LexGuard?

La ley se siente lejana y difícil cada vez que se necesita. Altos costos, terminología desconocida, una estructura donde no se sabe por dónde empezar.

LexGuard MCP (Pista Legal) comenzó con este problema.

• El usuario pregunta en lenguaje humano.

• La IA analiza la intención de la pregunta.

• Proporciona pistas basadas en datos oficiales de leyes y jurisprudencia.

No sustituye el juicio ni el asesoramiento legal. El objetivo es simplemente hacer que el primer encuentro con la ley sea menos difícil.

Características principales

Herramientas MCP

legal_qa_tool — QA Legal de propósito general

Es el punto de entrada único para todas las preguntas legales. Con una sola pregunta, explora y sintetiza leyes, jurisprudencia, interpretaciones y decisiones de comités en paralelo. Para búsquedas con fuentes limitadas (solo jurisprudencia, solo interpretaciones, etc.), puede revisar cada herramienta dedicada.

Capacidades

• Clasificación automática de 13 dominios

• Detección múltiple de intención de pregunta y ordenamiento por prioridad

• Búsqueda paralela de Ley → Jurisprudencia → Interpretación → Comité

• Filtrado de condiciones de tiempo en lenguaje natural (conversión automática de date_from / date_to)

Esquema de entrada

Ejemplos de Prompts

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

law_article_tool — Consulta precisa de artículos de ley

Consulta directamente un artículo específico cuando conoce el nombre de la ley y el número de artículo. Si legal_qa_tool es "exploración", esta herramienta es "consulta precisa".

Esquema de entrada

Ejemplos de Prompts

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

law_comparison_tool — Comparación de leyes (nueva/antigua, historial, 3 columnas)

Consulta resultados de comparación entre leyes nuevas y antiguas, historial y comparación de 3 columnas basadas en el nombre de la ley. Para consultar el texto original del artículo, use law_article_tool, y para preguntas generales, use legal_qa_tool.

Esquema de entrada

Ejemplos de Prompts

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

document_issue_tool — Análisis de contratos y términos

Al pegar un documento, extrae problemas legales por cláusula y busca automáticamente leyes y jurisprudencia relacionadas.

Esquema de entrada

Tipos de documentos admitidos

• labor — Contrato de trabajo / Contrato de servicios

• lease — Contrato de arrendamiento

• terms — Términos de uso

Ejemplos de Prompts

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

health — Verificación del estado del servidor

Verifica si el servidor MCP está funcionando, el estado de configuración de la clave API y las variables de entorno.

Herramientas de búsqueda dedicadas (fuentes limitadas)

Se utilizan cuando se busca solo datos específicos en lugar de una búsqueda integrada (legal_qa_tool).

Prompts de MCP

Admite los endpoints prompts/list y prompts/get.

Recursos de MCP

Admite los endpoints resources/list y resources/read.

Esquema URI

Recursos destacados (proporcionados por defecto)

Se pueden consultar inmediatamente leyes principales como la Ley de Normas Laborales, Código Civil, Código Penal, Ley de Protección de Información Personal, Código Comercial, Ley de Funcionarios Públicos, Ley de Litigios Administrativos, etc.

Instalación

Método 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

Método 2. Docker Compose (Recomendado · casi una línea)

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

URL de MCP para navegador/cliente: http://localhost:9099/mcp · Salud: http://localhost:9099/health

Método 3. Docker (solo run)

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

Método 4. MCP Remoto (URL de alojamiento)

Claude Desktop (claude_desktop_config.json)

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

Cursor (.cursor/mcp.json)

Igual al archivo examples/cursor-mcp.remote.json:

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

Emisión de clave API

Se requiere una clave Open API del Centro Nacional de Información Jurídica.

1. Registro en https://open.law.go.kr

2. Solicitud de uso de API

3. Configurar LAW_API_KEY=clave_recibida en .env

Arquitectura

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개 엔드포인트)

Pipeline de búsqueda

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

Stack tecnológico principal

Desarrollo

# 테스트 실행
pytest tests/ -v

# 린트
ruff check src/

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

Licencia

El texto completo sigue el archivo LICENSE en la raíz del repositorio.

• Uso: Al igual que con MIT, se permite el uso de investigación, personal y comercial, así como la modificación, distribución y reventa.

• Al vender/proporcionar bajo pago: Si vende este software por separado o lo incluye en un producto/servicio, debe incluir el aviso de derechos de autor y el texto de esta licencia en los materiales entregados al usuario final (documentos, pantallas de créditos/licencia, metadatos del paquete, etc.).

Esta guía es un resumen y el texto original de LICENSE tiene prioridad legal.

Contribución

Las Issues y PRs son siempre bienvenidas. Se agradecen datos del dominio legal, mejoras en la calidad de búsqueda e ideas para nuevas herramientas MCP.

LexGuard MCP — Encontramos la pista de la información legal. La ley es difícil, pero la primera pista puede ser fácil.