Argentina PJN Jurisprudencia - MCP Server Suite

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 (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:

{
  "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:

{
  "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:

   cd 06-pjn-juris-mcp/Argentina-PjnJuris-MCP

2. Instala las dependencias:

   npm install

3. Compila el código TypeScript a JavaScript:

   npm run build

4. Ejecuta el servidor compilado:

   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.

📝 Licencia

Este proyecto se distribuye bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.