legalize-mx-mcp

· v0.1.0, beta pública · cambios

MCP server y CLI para que agentes de IA consulten la legislación mexicana federal, estatal y municipal, con su historial de reformas.

Busca en el catálogo, lee el texto vigente o el que regía en una fecha, compara versiones y devuelve siempre el enlace oficial para citar.

Corre en tu máquina, sin servidor propio:

• Índice de búsqueda: se baja una vez del dataset elimoralsmendox/legalize-mx en Hugging Face (~90 MB) y se actualiza solo.

• Texto e historial: se piden por norma al repo público elimorals/legalize-mx, con un archivo Markdown por ley y un commit por reforma.

• Documentos oficiales: cuando una norma solo está catalogada, se bajan y se extraen en vivo del portal oficial (SCJN, congresos, periódicos oficiales, municipios). El DOF del día también se consulta en vivo.

Qué contiene

Cuándo no hay texto. No todas las normas tienen texto procesado todavía. En esos casos leer_norma lo dice y devuelve los documentos oficiales. Con extraer_en_vivo=true baja el documento y extrae su texto en ese momento. Un PDF escaneado sale vacío, porque necesita OCR.

Related MCP server: KriteriusMX

Instalación

Necesitas uv. Para extraer PDF en vivo hace falta además pdftotext (brew install poppler o apt install poppler-utils), o instalar el extra [pdf].

Claude Code: plugin con el MCP y la skill (recomendado)

/plugin install legalize-mx --marketplace elimorals/legalize-mx-mcp

Instala el MCP y la skill legalize-mx. La skill le enseña al agente cuándo consultarlo y en qué orden usar las herramientas, cómo citar la fuente y versión, y qué no cubre. Con Claude Code anterior a 2.1.275: /plugin marketplace add elimorals/legalize-mx-mcp y luego /plugin install legalize-mx.

Claude Code: solo el MCP

claude mcp add legalize-mx -- uvx --from git+https://github.com/elimorals/legalize-mx-mcp@v0.1.0 legalize-mx-mcp

Otros clientes MCP (.mcp.json, Claude Desktop, Cursor…)

{
  "mcpServers": {
    "legalize-mx": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/elimorals/legalize-mx-mcp@v0.1.0", "legalize-mx-mcp"],
      "env": { "GITHUB_TOKEN": "" }
    }
  }
}

Sin token, GitHub permite 60 consultas de historial por hora. El historial se guarda en caché 24 h. Con un GITHUB_TOKEN el límite sube a 5,000.

CLI

uvx --from git+https://github.com/elimorals/legalize-mx-mcp@v0.1.0 legalize-mx buscar "jornada laboral" --estado federal

Herramientas

En el CLI son los subcomandos buscar, leer, articulo, historial, diff, fuentes, cobertura, dof, nota-dof, actualizar e info.

Mantenerlo al día

El índice se publica de nuevo conforme entran normas y reformas. Tu copia local se mantiene así:

• Al arrancar: si pasaron más de 24 h desde la última revisión, el MCP consulta index/latest.json, que pesa unos bytes, y baja el índice solo si hay versión nueva.

• Mientras corre: si se publica un índice nuevo, buscar_norma, cobertura e info agregan a su respuesta un campo aviso_indice con el mensaje para el usuario. Con actualizar_indice() o legalize-mx actualizar se cambia a la versión nueva sin reiniciar.

• Si tu copia tiene más de 7 días, también aparece aviso_indice, porque lo publicado esos días puede faltar. Lo más reciente se confirma con dof_del_dia(), que consulta el DOF en vivo.

• El texto y el historial de cada ley siempre se leen del repo de GitHub, así que reflejan la última publicación aunque el índice sea de unos días antes.

Ejemplos

legalize-mx articulo CPEUM 27 --fecha 1920-01-01     # el artículo 27 original de 1917
legalize-mx diff LFT 2025-01-01                      # qué cambió en la LFT desde enero de 2025
legalize-mx buscar "protección civil" --municipio Zapopan
legalize-mx leer "muni-html:jal-zapopan:f30bbb480326df84" --en-vivo
legalize-mx cobertura --estado OAX
legalize-mx dof

Identificadores

• Leyes federales: usan su abreviatura de Diputados (CPEUM, LFT, LAMP…).

• Resto del catálogo de la SCJN: {ESTADO}-{titulo}-{id}.

• Otras fuentes: {fuente}:{id}, por ejemplo congreso-jal:… o dof:5801377.

buscar_norma siempre devuelve el id.

Documentación

• EJEMPLOS.md: llamadas reales con su respuesta y flujos completos de un agente.

• docs/HERRAMIENTAS.md: referencia de cada herramienta (parámetros, respuesta, errores, avisos).

• docs/DATOS.md: identificadores, campos, formato del repo y de los commits, esquema del índice.

• docs/FUENTES.md: las 53 fuentes oficiales con sus conteos.

• docs/ARQUITECTURA.md: cómo llega una norma del portal a la respuesta.

• docs/MANTENIMIENTO.md: publicar, reglas de integridad, evaluaciones y tests.

• docs/FAQ.md: confiabilidad, OCR, actualización, límites, licencia.

• ROADMAP.md: qué falta y en qué orden.

Servidor HTTP (opcional)

Para agentes que no pueden lanzar procesos locales:

legalize-mx-mcp --http --host 0.0.0.0 --port 8000     # streamable HTTP en /mcp

Corre igual en Hugging Face Spaces, Fly.io o cualquier VPS. No necesita base de datos: baja el mismo índice.

Variables de entorno

Actualizar el índice (mantenedores)

python3 scripts/build_index.py --data …/data-mx --repo …/legalize-mx --censo …/research-censo \
  --municipios …/municipios.json --out dist
scripts/publish_index.sh dist          # sube index/ al dataset de Hugging Face

Advertencia

Es una herramienta de consulta, no asesoría legal. El texto se obtiene automáticamente de fuentes oficiales y puede contener errores de origen o de conversión. Verifica siempre con la fuente oficial que devuelve fuentes() antes de usarlo en un asunto real.

Licencia

MIT para el código. Los textos legales son de dominio público: el art. 14, fr. VIII, de la Ley Federal del Derecho de Autor excluye de protección los textos legislativos y administrativos.