⚖️ LexGuard MCP (법실마리)

Servidor MCP que conecta leyes, jurisprudencia e interpretaciones legales de Corea en un formato fácil de entender para la IA

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

• Modo de ejecución: servidor MCP self-host que se ejecuta directamente con su propia clave API del Centro Nacional de Información Legal (sin servicio de alojamiento externo)

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

Inicio rápido (5 minutos)

1. Obtener clave API — Solicitud gratuita en open.law.go.kr. Es obligatorio registrar su IP al solicitarla (consulte Obtención de API Key a continuación)

2. Ejecutar el servidor

   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. Conexión del cliente — URL MCP: http://localhost:9099/mcp

   • Cursor: combine el contenido de examples/cursor-mcp.local.json en .cursor/mcp.json

   • Claude Desktop: combine examples/claude-desktop-mcp.local.json → en mcpServers de claude_desktop_config.json (requiere Node.js)

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

¿Por qué LexGuard?

La ley a menudo parece lejana y difícil cuando más se necesita. Altos costos, terminología desconocida, una estructura en la que no sabes por dónde empezar.

LexGuard MCP(법실마리) nació de este problema.

• El usuario pregunta en lenguaje humano

• La IA analiza la intención de la pregunta

• Y proporciona pistas basadas en datos oficiales de leyes y jurisprudencia

No reemplaza el juicio ni el asesoramiento legal. Sin embargo, su objetivo es hacer menos difícil el primer encuentro con la ley.

Related MCP server: LexLink

Funciones 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, busca y sintetiza en paralelo leyes, jurisprudencia, interpretaciones y decisiones de comités. Para búsquedas con fuentes limitadas (solo jurisprudencia, solo interpretaciones, etc.), puede revisar las herramientas dedicadas.

Capacidades

• Clasificación automática en 10 dominios

• Detección múltiple de intención (Intent) y ordenamiento por prioridad

• Búsqueda paralela: leyes → jurisprudencia → interpretaciones → comités

• 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 una disposición específica cuando se 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: anterior/nueva, historial, comparación de 3 columnas

Consulta resultados de comparación entre ley anterior y nueva, historial de enmiendas y comparación de 3 columnas según el nombre de la ley. Para consultar el texto original de artículos use law_article_tool; para preguntas generales use legal_qa_tool.

Esquema de entrada

Ejemplos de prompts

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

document_issue_tool — Análisis de contratos y términos y condiciones

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

Esquema de entrada

Tipos de documento compatibles

• labor — Contrato de trabajo / contrato de servicios

• lease — Contrato de arrendamiento

• terms — Términos y condiciones de uso

Ejemplos de prompts

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

health — Verificación del estado del servidor

Verifica el funcionamiento del servidor MCP, el estado de configuración de la clave API y las variables de entorno.

Herramientas de búsqueda dedicadas (fuente limitada)

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

Herramientas de consulta ampliada

Se usan cuando se necesita información adicional de la ley, historial, formularios, vinculaciones, etc.

ministry_interpretation_tool — Interpretaciones legales por ministerio

Busca en la base de datos de interpretaciones legales dedicadas (consultas y respuestas) de 39 ministerios. Si interpretation_tool es la búsqueda integrada, esta herramienta consulta directamente solo las interpretaciones de un ministerio específico.

Ministerios compatibles: Ministerio de Empleo y Trabajo, Ministerio de Territorio, Infraestructura y Transporte, Ministerio de Estrategia y Finanzas, Servicio de Impuestos Nacionales, Servicio de Aduanas, Ministerio de Educación, Ministerio de Salud y Bienestar, Ministerio de Justicia, Ministerio de Legislación Gubernamental, Agencia de Seguridad de Alimentos y Medicamentos, Agencia Nacional de Policía, Agencia Nacional de Bomberos, Guardia Costera y otras 39 instituciones

law_history_tool — Historial de cambios de leyes y artículos

Rastrea cuándo y cómo se enmendó una ley.

Ejemplos de prompts

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

law_info_tool — Información adicional de la ley

Consulta información adicional como leyes en inglés, tratados internacionales, estructura del sistema legal, resumen de un vistazo, abreviaturas, etc.

law_form_tool — Búsqueda de anexos y formularios

Busca anexos y formularios de leyes, reglas administrativas y normativa local por nombre de formulario o nombre de ley relacionada.

law_link_tool — Consulta de vinculación ley-normativa local

Verifica la lista de ordenanzas vinculadas a una ley específica, y el estado de vinculación por ministerio responsable y por gobierno local.

Prompts MCP

Admite los endpoints prompts/list y prompts/get.

Recursos MCP

Admite los endpoints resources/list y resources/read.

Esquema de URI

Recursos destacados (incluidos por defecto)

Se pueden consultar inmediatamente las principales leyes: Ley de Normas Laborales, Código Civil, Código Penal, Ley de Protección de Datos Personales, Código Comercial, Ley de Funcionarios Públicos Nacionales, 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 sola 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 MCP para navegador/cliente: http://localhost:9099/mcp · Health: 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

Conexión del cliente

Cuando el servidor se ejecuta localmente, la URL MCP es http://localhost:9099/mcp.

Cursor (.cursor/mcp.json) — idéntico al archivo examples/cursor-mcp.local.json:

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

Claude Desktop (claude_desktop_config.json) — idéntico al archivo examples/claude-desktop-mcp.local.json. Claude Desktop no admite URL HTTP locales directamente, por lo que se usa el puente mcp-remote (requiere Node.js):

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

Nota sobre el conector web de claude.ai: El conector web requiere una URL HTTPS pública, por lo que no puede conectarse a un servidor de ejecución local. Se recomienda usar Claude Desktop o Cursor. Si es imprescindible usarlo en la web, implemente el servidor en un servidor propio (IP fija + HTTPS) y registre esa IP en open.law.go.kr.

Obtención de API Key (obligatorio)

Se requiere la clave API de Open API del Centro Nacional de Información Legal. Tanto la emisión como el uso son gratuitos.

1. Regístrese en https://open.law.go.kr

2. Solicite el uso de OPEN API — en este paso debe registrar la IP o dominio del servidor (su PC) que enviará las solicitudes. law.go.kr solo permite solicitudes provenientes de IP registradas.

3. Configure LAW_API_KEY=clave_obtenida en .env

Aviso sobre IP dinámica: Las líneas domésticas normales pueden cambiar de IP. Si aparece el error "사용자 정보 검증에 실패하였습니다", vuelva a registrarla con la IP actual en [open.law.go.kr → API인증키관리].

Selección del esquema DRF

lexguard-mcp mantiene fijo el host/path de la URL DRF del Centro Nacional de Información Legal, y solo permite seleccionar el esquema mediante .env.

LAW_GO_KR_DRF_SCHEME=https

• Valores permitidos: http, https

• Predeterminado: https

• En entornos de red corporativa/firewall restringidos, puede ser necesario usar la ruta http://www.law.go.kr/DRF/... según los ejemplos de la guía oficial.

Esta configuración es una opción para ajustar por entorno operativo el problema latente de generación de URL donde el https codificado podía quedar oculto accidentalmente en entornos normales.

Arquitectura

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)

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 se rige por el archivo LICENSE en la raíz del repositorio.

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

• Venta u oferta de pago: Si se vende este software por separado o se vende incluido en un producto o servicio, se debe incluir el aviso de copyright y el texto de esta licencia en los materiales entregados al usuario final (documentación, pantallas de créditos o de licencia, metadatos del paquete, etc.).

Esta guía es un resumen; el texto original de LICENSE prevalece a efectos legales.

Contribución

Issues y PRs son siempre bienvenidos. Los datos del dominio legal, la mejora de la calidad de búsqueda y las nuevas ideas de herramientas MCP son todos bienvenidos.

LexGuard MCP — Le ayudamos a encontrar la pista de la información legal. La ley es difícil, pero la primera pista puede resultar más fácil.