Content
# Argentina PJN Jurisprudencia - MCP Server Suite
[](https://www.typescriptlang.org/)
[](https://modelcontextprotocol.io/)
[](https://pjn-juris-mcp.vercel.app)
[](https://www.npmjs.com/package/pjn-juris-mcp)
MCP Server Oficial para buscar y extraer jurisprudencia federal del Poder Judicial de la Nación (PJN). Conector para consultar fallos, sentencias, resoluciones y sumarios desde pjn.gov.ar.
---
## 🚀 Características Principales
* **Búsqueda por Expediente (`pjn_buscar_jurisprudencia_por_expediente`)**: Busca jurisprudencia por número de expediente.
* **Búsqueda por Carátula (`pjn_buscar_jurisprudencia_por_caratula`)**: Busca por nombre de las partes.
* **Búsqueda por Fallo (`pjn_buscar_jurisprudencia_por_fallo`)**: Busca por datos de sentencia.
* **Búsqueda de Texto CSJN (`pjn_buscar_jurisprudencia_por_texto_corte_suprema`)**: Busca texto en Corte Suprema.
* **Búsqueda de Texto Cámaras (`pjn_buscar_jurisprudencia_por_texto_camaras`)**: Busca texto en Cámaras Nacionales y Federales.
* **Búsqueda de Sumarios (`pjn_buscar_sumarios`)**: Busca en extractos de la Secretaría de Jurisprudencia.
* **Guía Judicial (`pjn_buscar_guia_judicial`)**: Busca en el directorio de tribunales y personal judicial.
* **Concursos Judiciales (`pjn_consultar_concursos`)**: Consulta concursos de empleo y judiciales.
* **Formularios CSJN (`pjn_buscar_formularios_csjn`)**: Accede a formularios de la Corte Suprema (Acordada 12/2020).
* **Estadísticas (`pjn_estadisticas`)**: Accede a datos estadísticos por jurisdicción y fuero.
* **Descarga de Fallos (`pjn_descargar_fallo_pdf`)**: Descarga PDF/Word de sentencias.
* **Análisis de Plazos (`detector_plazos_jurisprudencia`)**: Detecta plazos y fechas límite en fallos.
* **Búsqueda Semántica (`buscar_por_semantica`)**: Búsqueda con expansión de términos.
* **Relación de Fallos (`relacionar_fallos`)**: Busca fallos relacionados.
* **Certificación Forense (`generar_certificacion_forense`)**: Certificación con hash SHA-256.
* **Exportación Estructurada (`exportar_fallo`)**: Exporta a Markdown con frontmatter YAML.
* **Navegador Interactivo HITL**: Tools `iniciar_hitl_browser` y `finalizar_hitl_browser` para resolver CAPTCHAs.
* **Prompt de Investigación**: Prompt preconfigurado `investigacion_jurisprudencia`.
* **Alcance de Fuente**: Tool `alcance_fuente` para informar capacidades y disclaimer.
---
## ⚠️ Limitación Crítica: CAPTCHA
> **Advertencia Importante:** El portal del PJN está protegido por Google reCAPTCHA. Las consultas en vivo requieren resolución manual del CAPTCHA.
>
> **Flujo de trabajo recomendado:**
> 1. Ejecutar `iniciar_hitl_browser` para abrir un navegador interactivo
> 2. Resolver el CAPTCHA manualmente en el navegador
> 3. Ejecutar `finalizar_hitl_browser` para obtener el token
> 4. Usar el token en `buscar_jurisprudencia_fed`
---
## 🛠️ Instalación y Configuración Rápida
Para utilizar este servidor MCP de forma inmediata, necesitas tener instalado [Node.js](https://nodejs.org/) (versión 18 o superior).
### 1. Cursor IDE / Windsurf
Tanto Cursor como Windsurf admiten servidores MCP de forma nativa a través del protocolo standard I/O (`stdio`):
1. Abre la configuración (Settings) de tu entorno y busca la sección **MCP**.
2. Haz clic en **+ Add New MCP Server**.
3. Completa los campos requeridos:
* **Name:** `pjn-juris-mcp`
* **Type:** `command`
* **Command:** `node`
* **Args:** `D:/MCP/Legales/06-pjn-juris-mcp/Argentina-PjnJuris-MCP/build/index.js`
* **Env:** `NODE_TLS_REJECT_UNAUTHORIZED=0`
### 2. Claude Desktop
1. Abre tu archivo de configuración de Claude Desktop. En Windows:
`C:\Users\<TuUsuario>\AppData\Roaming\Claude\claude_desktop_config.json`
2. Agrega el servidor dentro de la clave `mcpServers`:
```json
{
"mcpServers": {
"pjn-juris-mcp": {
"command": "node",
"args": ["D:/MCP/Legales/06-pjn-juris-mcp/Argentina-PjnJuris-MCP/build/index.js"],
"env": {
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
}
}
}
}
```
> [!IMPORTANT]
> La variable de entorno `"NODE_TLS_REJECT_UNAUTHORIZED": "0"` es fundamental para saltear problemas periódicos con los certificados SSL vencidos o mal configurados de los sitios gubernamentales argentinos.
### 3. Antigravity / Codex
Configura el servidor en tu archivo de configuración global `mcp_config.json`:
```json
{
"mcpServers": {
"pjn-juris-mcp": {
"command": "node",
"args": ["D:/MCP/Legales/06-pjn-juris-mcp/Argentina-PjnJuris-MCP/build/index.js"],
"env": {
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
}
}
}
}
```
---
## 💻 Instalación Manual (Para Desarrolladores)
Si deseas descargar el código fuente, auditar la lógica de scraping o contribuir al desarrollo local:
1. Ubícate en el directorio del conector:
```bash
cd 06-pjn-juris-mcp/Argentina-PjnJuris-MCP
```
2. Instala las dependencias:
```bash
npm install
```
3. Compila el código TypeScript a JavaScript:
```bash
npm run build
```
4. Ejecuta el servidor compilado:
```bash
npm start
```
---
## ⚖️ Catálogo de Herramientas Disponibles (20 Tools)
El servidor expone **20 herramientas (tools)** diseñadas para buscar jurisprudencia federal del PJN, con cobertura de **28 jurisdicciones**.
### Herramientas de Búsqueda
| Herramienta | Descripción | Parámetro principal |
|---|---|---|
| `pjn_buscar_jurisprudencia_por_expediente` | Busca jurisprudencia por número de expediente | `numero`, `anio`, `camara_id`, `captchaToken` |
| `pjn_buscar_jurisprudencia_por_caratula` | Busca por nombre de las partes | `caratula`, `camara_id`, `captchaToken` |
| `pjn_buscar_jurisprudencia_por_fallo` | Busca por datos de sentencia | `numero_sentencia`, `magistrado`, `camara_id`, `captchaToken` |
| `pjn_buscar_jurisprudencia_por_texto_corte_suprema` | Busca texto en Corte Suprema | `texto_contiene`, `captchaToken` |
| `pjn_buscar_jurisprudencia_por_texto_camaras` | Busca texto en Cámaras Nacionales y Federales | `texto_contiene`, `camara_id`, `captchaToken` |
| `pjn_buscar_sumarios` | Busca en extractos de la Secretaría de Jurisprudencia | `texto_contiene`, `camara_id`, `captchaToken` |
| `pjn_buscar_guia_judicial` | Busca en el directorio de tribunales y personal judicial | `tribunal`, `fuero`, `localidad`, `captchaToken` |
| `pjn_consultar_concursos` | Consulta concursos de empleo y judiciales | `fuero`, `estado`, `fecha_desde`, `captchaToken` |
| `pjn_buscar_formularios_csjn` | Accede a formularios de la Corte Suprema (Acordada 12/2020) | `tipo_formulario`, `fuero`, `captchaToken` |
| `pjn_estadisticas` | Accede a datos estadísticos por jurisdicción y fuero | `jurisdiccion`, `fuero`, `anio`, `captchaToken` |
| `buscar_jurisprudencia_fed` | Búsqueda original de fallos federales | `criterio`, `captchaToken` |
### Herramientas de Descarga
| Herramienta | Descripción | Parámetro principal |
|---|---|---|
| `pjn_descargar_fallo_pdf` | Descarga PDF/Word de sentencias | `fallo_id`, `captchaToken` |
### Herramientas de Análisis y Relación
| Herramienta | Descripción | Parámetro principal |
|---|---|---|
| `detector_plazos_jurisprudencia` | Detecta plazos y fechas límite en fallos | `texto_fallo` |
| `relacionar_fallos` | Busca fallos relacionados | `criterio_base`, `terminos_relacionados`, `captchaToken` |
| `buscar_por_semantica` | Búsqueda semántica con expansión de términos | `concepto`, `terminos_equivalentes`, `captchaToken` |
### Herramientas de Exportación y Certificación
| Herramienta | Descripción | Parámetro principal |
|---|---|---|
| `generar_certificacion_forense` | Certificación forense con hash SHA-256 | `fallo_id`, `captchaToken` |
| `exportar_fallo` | Exporta a Markdown con frontmatter YAML | `fallo_id`, `captchaToken` |
### Herramientas de Gestión
| Herramienta | Descripción | Parámetro principal |
|---|---|---|
| `iniciar_hitl_browser` | Abre navegador interactivo para CAPTCHAs | *(ninguno)* |
| `finalizar_hitl_browser` | Cierra navegador y obtiene token | *(ninguno)* |
| `alcance_fuente` | Cobertura, capacidades y disclaimer | *(ninguno)* |
**Prompts:** `investigacion_jurisprudencia`.
Parámetros detallados: [TOOLS.md](./TOOLS.md).
---
## 📝 Licencia
Este proyecto se distribuye bajo la **Licencia MIT**. Consulta el archivo [LICENSE](./LICENSE) para más detalles.
