open-rakiduam-juris
# Open Rakiduam Juris ⚖️🇨🇱
> **Servidor MCP Universal de Jurisprudencia Chilena en Tiempo Real (Anti-Alucinación Estricta)**
> Una iniciativa de código abierto de la **Fundación Rakiduam** para democratizar el acceso al derecho y dotar a agentes de Inteligencia Artificial (Antigravity, Claude, Codex, Cursor) de anclaje fáctico inmutable en resoluciones judiciales del Estado de Chile.
---
## 🏛️ Fuentes Conectadas en Tiempo Real
1. **Poder Judicial de Chile (PJUD):**
* **Corte Suprema de Chile** (`id_buscador: 528`)
* **Cortes de Apelaciones de todo el país** (`id_buscador: 168`)
* Extracción de fallos íntegros (considerandos y vistos) sin bloqueos de descarga.
2. **Tribunal Constitucional de Chile (TC):**
* Sentencias de Inaplicabilidad por Inconstitucionalidad, Control de Constitucionalidad y Contiendas de Competencia.
* Identificación de normas y preceptos legales impugnados.
3. **Contraloría General de la República (CGR):**
* Dictámenes, instructivos y pronunciamientos jurídicos administrativos en materias de probidad, municipios, salud y compras públicas.
---
## 🛡️ Principios Éticos y Forenses (Fundación Rakiduam)
* **Cero Alucinación (Grounding Estricto):** Cada resolución devuelta incluye su **SHA-256 de verificación fáctica**, URL oficial inmutable y herramienta de auditoría de citas literales.
* **Fidelidad Textual (*Verbatim*):** No altera ni recorta el texto público oficial publicado por los tribunales, respetando íntegramente el texto y la reserva original dispuesta por cada organismo del Estado.
* **Consulta Interactiva Responsable:** No realiza almacenamiento masivo ni scraping indebido; opera como puente de consulta en tiempo real para agentes, abogados y peritos.
---
## 🚀 Instalación y Uso Rápido con `uv`
Este proyecto utiliza [uv](https://github.com/astral-sh/uv) para ejecución instantánea y aislada.
```bash
# Clonar o ubicarse en el directorio
cd /home/dano/Documentos/open-rakiduam-juris
# Ejecutar el servidor en modo stdio
uv run open-rakiduam-juris
```
---
## 🔌 Configuración para Agentes de Inteligencia Artificial
### 1. Google Antigravity
En la configuración de servidores MCP de tu workspace (`~/.gemini/antigravity/mcp/open-rakiduam-juris.json` o settings de Antigravity):
```json
{
"mcpServers": {
"open-rakiduam-juris": {
"command": "uv",
"args": [
"run",
"--directory",
"/home/dano/Documentos/open-rakiduam-juris",
"open-rakiduam-juris"
]
}
}
}
```
### 2. Claude Desktop (`~/.config/Claude/claude_desktop_config.json`)
```json
{
"mcpServers": {
"open-rakiduam-juris": {
"command": "uv",
"args": [
"run",
"--directory",
"/home/dano/Documentos/open-rakiduam-juris",
"open-rakiduam-juris"
]
}
}
}
```
### 3. Claude Code (CLI)
```bash
claude mcp add open-rakiduam-juris uv -- run --directory /home/dano/Documentos/open-rakiduam-juris open-rakiduam-juris
```
### 4. OpenAI Codex / Cursor / Roo-Code
Agregar en `.cursor/mcp.json` o en los ajustes MCP del editor:
```json
{
"mcpServers": {
"open-rakiduam-juris": {
"command": "uv",
"args": [
"run",
"--directory",
"/home/dano/Documentos/open-rakiduam-juris",
"open-rakiduam-juris"
]
}
}
}
```
---
## 🛠️ Herramientas Expuestas (MCP Tools)
| Herramienta | Descripción | Parámetros Principales |
|---|---|---|
| `buscar_jurisprudencia_pjud` | Busca sentencias en Corte Suprema y Cortes de Apelaciones con metadatos y URL oficial. | `query` (str), `tribunal` ("suprema" \| "apelaciones"), `limite` (int) |
| `obtener_sentencia_pjud` | Recupera el texto íntegro, todos los considerandos y ministros redactores por ID. | `id_documento` (str), `tribunal` (str) |
| `buscar_sentencias_tc` | Busca fallos en el Tribunal Constitucional y normas legales impugnadas. | `query` (str), `tipo_accion` (str opcional), `limite` (int) |
| `buscar_dictamenes_cgr` | Busca dictámenes en Contraloría General de la República en materias de función pública. | `query` (str), `limite` (int) |
| `verificar_cita_jurisprudencia` | **Auditoría Anti-Alucinación:** Contrasta una cita textual contra el fallo oficial original. | `id_documento` (str), `cita_propuesta` (str), `tribunal` (str) |
---
## 💬 Guía de Uso: ¿Cómo pedirle cosas a tu Agente? (Antigravity, Claude, Codex)
Una vez conectado el servidor MCP a tu agente, no necesitas escribir código ni llamar funciones técnicas. **Solo le hablas en lenguaje natural en el chat**, y el agente activará automáticamente las herramientas del servidor.
### 📝 Ejemplos de Prompts Listos para Usar:
#### 1. Búsqueda y Análisis en Corte Suprema o Apelaciones
> *"Busca jurisprudencia reciente de la Corte Suprema sobre 'despido injustificado y tutela laboral'. Tráeme el fallo más reciente, rescata el texto íntegro y explícame los considerandos principales sin inventar nada."*
#### 2. Auditoría Anti-Alucinación de Citas Textuales
> *"Quiero citar el fallo Rol 43.901-2026 de la Corte Suprema en mi informe pericial. Verifica si la siguiente frase es 100% auténtica y en qué considerando exacto aparece: 'la acción de despido injustificado queda supeditada a la acción de declaración de relación laboral'."*
#### 3. Búsqueda de Inconstitucionalidad en el Tribunal Constitucional
> *"Busca sentencias del Tribunal Constitucional sobre inaplicabilidad por vulneración del debido proceso respecto del artículo 470 del Código del Trabajo. Entrégame el Rol, la fecha y el enlace directo de descarga del PDF oficial."*
#### 4. Dictámenes de la Contraloría General de la República
> *"Busca los últimos dictámenes de Contraloría sobre 'probidad administrativa y sumarios en corporaciones municipales de salud'. Dame el número de dictamen, fecha y el enlace al lector HTML oficial."*
---
## 🔄 Flujo de Trabajo Anti-Alucinación (Zero-Hallucination Pipeline)
```
[Usuario le pide un fallo al Agente]
│
▼
1. Búsqueda en vivo (PJUD / TC / CGR) ──────► Rescata Roles, Fechas y URLs reales
│
▼
2. Extracción Íntegra Verbatim ────────────► Descarga el texto judicial completo (7k a 45k+ chars)
│
▼
3. Auditoría de Citas (SHA-256) ───────────► Contrasta cada considerando letra por letra
│
▼
[Respuesta Final con Garantía Fáctica Inmutable y Enlace Oficial]
```
---
## ⚖️ Legalidad y Cumplimiento Normativo: ¿Por qué este proyecto es 100% legal?
`open-rakiduam-juris` opera en estricta conformidad con el ordenamiento jurídico de la República de Chile, bajo los siguientes cuatro fundamentos legales expresos:
### 1. Ausencia de Derechos de Autor sobre Resoluciones Judiciales (Ley N° 17.336)
El **Artículo 8° de la Ley sobre Propiedad Intelectual (Ley N° 17.336)** establece de forma tajante e inequívoca:
> *"No gozan de la protección de esta ley los textos de las leyes, decretos, reglamentos oficiales, **resoluciones de los tribunales de justicia y de los actos públicos de los órganos del Estado**."*
Por expresa disposición legal, los fallos de la Corte Suprema, de las Cortes de Apelaciones, del Tribunal Constitucional y los dictámenes de la Contraloría General de la República **son de dominio público**. Ninguna entidad, pública ni privada, puede atribuirse propiedad intelectual o derechos de copia sobre la jurisprudencia del Estado.
### 2. Principio Constitucional de Publicidad y Transparencia
* **Constitución Política de la República (Art. 8°, inc. 2°):** *"Son públicos los actos y resoluciones de los órganos del Estado, así como sus fundamentos y los procedimientos que utilicen..."*
* **Código Orgánico de Tribunales (Art. 9°):** *"Los actos de los tribunales son públicos, salvo las excepciones expresamente establecidas por la ley."*
* **Ley N° 20.886 sobre Tramitación Electrónica:** Consagra el principio de publicidad y acceso abierto a las actuaciones y sentencias firmes emitidas por los tribunales del país a través de medios telemáticos.
### 3. Conformidad con la Ley de Delitos Informáticos (Ley N° 21.459)
Este software **NO constituye hacking, vulneración ni intrusión indebida**:
* **Acceso a Fuentes Públicas Abiertas:** Los portales de jurisprudencia (`juris.pjud.cl`, `buscador.tcchile.cl`, `contraloria.cl`) son servicios web de acceso público y universal abiertos a toda la ciudadanía sin requerir clave de usuario, pago de aranceles ni autenticación restringida.
* **Mecanismo de Solo Lectura:** El servidor opera exactamente igual que un navegador web convencional (como Google Chrome o Mozilla Firefox), emitiendo peticiones HTTP estándar de lectura (`GET`/`POST`) para consultar resoluciones específicas solicitadas por el usuario.
* **Sin Alteración de Sistemas:** No modifica, destruye ni obstaculiza datos, programas o sistemas informáticos del Estado (cumplimiento de Arts. 1, 2 y 3 de la Ley N° 21.459).
### 4. Tratamiento Ético de Datos Personales (Ley N° 19.628)
* La **Ley N° 19.628 sobre Protección de la Vida Privada** autoriza el tratamiento de datos provenientes de **fuentes de acceso público**.
* Los tribunales de justicia, en virtud de sus facultades legales y autos acordados de la Excma. Corte Suprema, **ya aplican en origen los filtros de reserva y anonimización obligatorios** respecto de causas sensibles (como materias de familia, filiación, violencia intrafamiliar y menores de edad) antes de liberar cualquier fallo a sus buscadores públicos.
* Este proyecto es una herramienta de consulta interactiva puntual en memoria; **no realiza acopio, almacenamiento masivo ni venta de bases de datos de litigantes**.
---
## 🧪 Pruebas Automatizadas
```bash
cd /home/dano/Documentos/open-rakiduam-juris
# Ejecutar suite de pruebas completa en vivo (PJUD, TC, CGR y Verificador)
uv run pytest -v
```
---
## 📜 Licencia y Atribución (Uso No Comercial)
Desarrollado para la **Fundación Rakiduam** por Daniel Rivera Araneda.
Licenciado bajo **Creative Commons Atribución-NoComercial-CompartirIgual 4.0 Internacional (CC BY-NC-SA 4.0)**.
* ✅ **Uso gratuito y abierto** para peritos, abogados, investigadores, estudiantes y la comunidad jurídica.
* ❌ **Prohibido su uso comercial:** No se permite la venta, reventa ni comercialización del software ni de sus derivados.
* 🔄 **Compartir Igual:** Cualquier mejora debe mantenerse abierta bajo la misma licencia.
Ver el archivo [`LICENSE`](LICENSE) para los términos completos.
TDQS
Scored across 5 tools
Each tool targets a distinct resource + action pair: search PJUD jurisprudence, fetch a PJUD ruling by id, search Constitutional Court rulings, search CGR opinions, and verify a citation. The institutional scope (PJUD vs TC vs CGR) is stated explicitly in every description, so an agent can select without guessing. The only mild similarity — two 'search' tools — is resolved by the different source courts.
All five names follow a strict Spanish verb_noun snake_case pattern (buscar_*, obtener_*, verificar_*) with the data source as a suffix. Conventions are uniform and predictable, making new tools easy to anticipate.
Five tools is a tight, purpose-fit surface for a Chilean legal research server: one search per source plus a retrieval and an anti-hallucination check. No tool appears redundant or filler.
The surface covers search across the three main Chilean legal sources, verbatim retrieval for PJUD, and citation verification — the core research lifecycle. Minor gaps exist: no direct fetch-by-id for TC or CGR documents, and no explicit filtering/pagination parameters for large result sets, though full text is returned by the search tools.