MCP-CENDOJ

MCP-CENDOJ: Servidor MCP y API para el Buscador de Jurisprudencia

Este proyecto proporciona unaAPI REST (FastAPI)y unServidor MCP (Model Context Protocol)para buscar y consultar sentencias y resoluciones judiciales delCENDOJ(Centro de Documentación Judicial de España).

Dado que el CENDOJ no dispone de una API pública y protege sus búsquedas con Javascript interactivo y validaciones de autocompletado, este servicio utilizaPlaywrightpara simular búsquedas reales de forma automatizada y robusta, devolviendo resultados limpios en formato JSON y abstrayendo la descarga y extracción de texto de los PDFs de sentencias.

- Buscador Automatizado (Playwright):Automatiza la navegación, la aceptación del Aviso Legal, la simulación de escritura secuencial para activar el buscador y la selección de la sugerencia del CENDOJ para evitar las limitaciones de búsqueda.
- API REST con FastAPI:

- GET /api/status: Verifica la salud y configuración del servicio.
- GET /api/search: Realiza búsquedas avanzadas con parámetros:

- query: Texto libre opcional.
- fecha_desde/fecha_hasta: Rango de fechas (YYYY-MM-DD o DD/MM/AAAA).
- jurisdiccion: Civil, Penal, Contencioso-Administrativo, Social, Militar.
- roj: Identificador ROJ (ej.STS 2849/2026).
- ecli: Código ECLI (ej.ES:TS:2026:2849).
- n_resolucion: Número de resolución.
- n_recurso: Número de recurso.
- ponente: Nombre del magistrado ponente.
- norma: Legislación o norma de interés.
- localizacion: Lista de localizaciones o Comunidades Autónomas (ej.Andalucía,Cataluña,Madrid).

- Soporte para modoStdio(para clientes locales de escritorio como Cursor y Claude Desktop).
- Soporte para modoSSE (Server-Sent Events)montado de forma nativa en FastAPI bajo el prefijo/mcp(para clientes remotos o web).
- Herramientas expuestas:

- buscar_jurisprudencia: Realiza búsquedas con todos los filtros detallados (query, roj, ecli, ponente, recurso, resolución, norma, etc.).
- obtener_texto_resolucion: Descarga un PDF y extrae su texto completo.

- Python 3.10 o superior instalado.
- Navegador Chromium de Playwright instalado en el sistema.

Para facilitar la configuración en Windows, hemos incluido scripts que automatizan todo el proceso:
-

Ejecutar configuración automática:Haz doble clic en el archivosetup.bat(o ejecútalo desde tu consola). Este script se encargará de:

- Crear el entorno virtual.venv.
- Instalar y actualizar todas las dependencias (requirements.txt).
- Instalar el navegador Chromium requerido por Playwright.
- Crear el archivo de configuración.envpor defecto.

Registrar en Clientes MCP (Automático):Una vez finalizado el setup, ejecuta la utilidad de instalación automática para vincular el servidor MCP con tus clientes locales:

Este comando detectará la ruta absoluta de tu repositorio yregistrará automáticamenteel servidor CENDOJ en las configuraciones globales de:

- Claude Desktop(claude_desktop_config.json)
- Antigravity IDE(mcp_config.json)