Skip to main content
Glama
README.md
# 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

A3.7/5.0

Scored across 5 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues