# 📚 Hub de Jurisprudencia Argentina - MCP

Un **servidor proxy MCP** que unifica **15 fuentes jurídicas argentinas oficiales** en un único conector de Claude Desktop. Acceso simultáneo a CSJN, PJN, SAIJ, BORA, InfoLEG y más.

## 🎯 Funcionalidad

Cuatro herramientas principales:

1. **search_jurisprudencia** - Búsqueda unificada en todas las fuentes
2. **get_fallo_completo** - Obtener texto completo con análisis
3. **list_juridical_sources** - Enumerar las 15 fuentes integradas
4. **get_hub_status** - Estado del hub y conectores activos

## 🚀 Instalación Rápida

### 1. Clonar y instalar

```bash
cd /ruta/a/tu/proyecto
git clone <tu-repo> legal-ar-mcp-hub
cd legal-ar-mcp-hub
npm install
npm run build
```

### 2. Configurar Claude Desktop

**Archivo:** `~/.config/Claude/claude_desktop_config.json` (Linux/Mac)

```json
{
  "mcpServers": {
    "legal-ar-mcp-hub": {
      "command": "node",
      "args": ["/ruta/absoluta/a/legal-ar-mcp-hub/dist/index.js"]
    }
  }
}
```

### 3. Reiniciar Claude Desktop ↻

### 4. ¡Usar!

```
Claude: Busca sentencias argentinas sobre derecho laboral
```

## 📖 Documentación

- **[ARQUITECTURA.md](docs/ARQUITECTURA.md)** - Cómo funciona el hub internamente
- **[DIRECTIVA_OPERATIVA.md](docs/DIRECTIVA_OPERATIVA.md)** - Reglas de uso y verificación
- **[BUSQUEDA_JURISPRUDENCIA.md](docs/BUSQUEDA_JURISPRUDENCIA.md)** - Guía completa de búsqueda

## 🔗 Fuentes Integradas

| # | Fuente | Descripción | Tipo |
|---|--------|-------------|------|
| 1 | **BORA** | Boletín Oficial (1938-2026) | API |
| 2 | **InfoLEG** | Leyes y normas nacionales | API |
| 3 | **SAIJ** | 330.000+ documentos jurídicos | API/Scrape |
| 4 | **PJN Jurisprudencia** | Fallos de cámaras nacionales | API + HITL |
| 5 | **CSJN** | Corte Suprema (1863-2026) | Fetch + Sesión |
| 6 | **PJN Consulta** | Estado de expedientes | HITL + Captcha |
| 7 | **Portal PJN** | Feed de novedades | SSO + API |
| 8 | **JusCABA** | Expedientes CABA | API Pública |
| 9 | **MEV** | Expedientes SCBA | Form + Login |
| 10 | **PTN** | Procuración Tesoro | Scrape |
| 11 | **TFN** | Tribunal Fiscal | API |
| 12 | **BOPBA** | Boletín Oficial PBA | Scrape |
| 13 | **Normativa PBA** | Legislación PBA | Scrape |
| 14 | **JUBA** | Jurisprudencia SCBA | API |
| 15 | **SCBA** | Sentencias SCBA | API |

## 🔐 Seguridad y Privacidad

✅ **Transporte local (stdio)** - Sin intermediarios  
✅ **Solo lectura** - No escribe ni ejecuta  
✅ **CAPTCHA manual** - Vos resuelves, no la máquina  
✅ **Auditable** - Código fuente completo en GitHub  
✅ **Sin registro** - Consultas no se guardan  
✅ **Sin tracking** - Datos no se envían a terceros  

## 📊 Niveles de Verificación

Cada resultado incluye su nivel de confiabilidad:

- **VERIFICADO**: Fallo original, auténtico, vigente
- **REFERENCIA_VERIFICADA**: Referencia oficial confirmada
- **INFERIDO**: Información cruzada entre fuentes
- **NO_VERIFICADO_PARCIAL**: Parcialmente verificado
- **NO_VERIFICADO**: Sin verificación
- **CONFLICTO**: Fuentes contradicen

## 💡 Casos de Uso

### 1. Investigación Legal Rápida
```
"¿Hay jurisprudencia sobre indemnizaciones en derecho laboral?"
→ Hub busca en CSJN, PJN, SAIJ, SCBA y más
→ 20+ fallos en segundos
```

### 2. Análisis de Jurisprudencia
```
"Encuentra sentencias sobre custodia de menores en los últimos 2 años"
→ Filtra por materia, tribunal y fecha
→ Resultados con nivel de confiabilidad
```

### 3. Búsqueda de Normativa Vigente
```
"¿Cuál es la legislación actual sobre contrato de trabajo?"
→ InfoLEG + BORA + leyes provinciales
→ Texto vigente con histórico de modificaciones
```

### 4. Consulta de Expedientes
```
"¿Cuál es el estado de mi expediente en juzgado?"
→ Integración con PJN, JusCABA, MEV
→ Actuaciones, sentencias, PDF
```

## 🛠️ Extensibilidad

Agregar una nueva fuente es simple:

1. Crear conector en `src/connectors/mi-fuente.ts`
2. Registrarlo en `src/hub/tool-registry.ts`
3. Ya está disponible en todas las búsquedas

Ver [ARQUITECTURA.md](docs/ARQUITECTURA.md#extensibilidad) para detalles.

## ⚙️ Configuración

Variables de entorno:

```bash
# Credenciales (opcionales)
MEV_USERNAME=tu_usuario
MEV_PASSWORD=tu_contraseña
PJN_SSO_TOKEN=tu_token

# Comportamiento
SEARCH_TIMEOUT=30000          # ms
RETRY_ATTEMPTS=3
CACHE_TTL=3600               # segundos
MAX_RESULTS_PER_SOURCE=100
```

## 🧪 Testing

### Con MCP Inspector

```bash
npm run build
npx @modelcontextprotocol/inspector node dist/index.js
```

Abre interfaz web para probar herramientas interactivamente.

### Con Claude Desktop

Una vez integrado, prueba directamente en chat.

## 📈 Rendimiento

- **Búsqueda paralela**: Consulta todas las fuentes simultáneamente
- **Caché local**: Evita búsquedas duplicadas
- **Retry automático**: Tolerancia a fallos temporales
- **Timeouts**: Conector lento no bloquea otros

## 🐛 Troubleshooting

### "Module not found"
```bash
npm install
npm run build
```

### Servidor no aparece en Claude Desktop
- Verifica ruta absoluta en config
- Asegúrate de haber compilado
- Reinicia Claude Desktop

### Búsquedas lentas
- Reduce `MAX_RESULTS_PER_SOURCE`
- Filtra por fuentes específicas
- Aumenta timeout si es necesario

## 📞 Soporte

- Reporta bugs en GitHub Issues
- Lee la documentación en `docs/`
- Consulta logs con `npm run dev`

## 📝 Licencia

MIT

## ✨ Créditos

Hub desarrollado por: **Jackie Ocampo** - Fundación Innovación con Inclusión

Conectores basados en trabajo de la comunidad legal tech argentina.

---

**¿Preguntas?** Consulta [ARQUITECTURA.md](docs/ARQUITECTURA.md) o abre un issue.

🚀 **¡Listo para revolucionar tu investigación jurídica!**