Argentina PJN Consulta MCP

Servidor MCP (Model Context Protocol) para consultar expedientes del Poder Judicial de la Nación (PJN). Conecta cualquier LLM compatible (Claude, Cursor, Antigravity) con el portal oficial del PJN para consultar el estado de expedientes judiciales federales y obtener las últimas actuaciones judiciales con fidelidad jurídica sin alucinaciones.

🚀 Características Principales

• Consulta de Expedientes (consultar_expediente): Consulta el estado de expedientes judiciales federales por jurisdicción, cámara, número o año.
• Búsqueda por Parte (pjn_buscar_expediente_por_parte): Busca expedientes filtrando por el nombre exacto de las partes involucradas (con 40 tipos de partes).
• Resoluciones (pjn_obtener_resoluciones_expediente): Obtiene únicamente las resoluciones, autos y sentencias de un expediente.
• Reparación Histórica (pjn_buscar_reparacion_historica): Busca reclamos de ANSES (jubilados y pensionados).
• Gestión Documental (pjn_buscar_gestion_documental): Busca documentos en la Plataforma de Gestión Documental (resoluciones, contratos, actos administrativos).
• Descarga de Documentos (pjn_descargar_documento_actuacion): Descarga el documento PDF original adjunto a una actuación procesal.
• Descarga Gestión Documental (pjn_descargar_documento_gestion): Descarga documentos de la Plataforma de Gestión Documental.
• Actuaciones (obtener_actuaciones): Lista las últimas actuaciones judiciales y resoluciones cargadas en el expediente.
• Análisis de Plazos (detector_plazos_judiciales): Detecta plazos, fechas límite y hitos temporales en actuaciones judiciales.
• Búsqueda Semántica (buscar_por_semantica): Busca expedientes utilizando expansión semántica de términos.
• Relación de Expedientes (relacionar_expedientes): Busca expedientes relacionados por tema o partes.
• Certificación Forense (generar_certificacion_forense): Genera certificación con hash SHA-256 para documentos.
• Exportación Estructurada (exportar_expediente): Exporta expedientes a Markdown con frontmatter YAML.
• Navegador Interactivo HITL: Tools iniciar_hitl_browser y finalizar_hitl_browser para resolver CAPTCHAs manualmente.
• Prompt de Consulta: Prompt preconfigurado consulta_expediente para automatizar flujos de consulta judicial.
• Alcance de Fuente: Tool alcance_fuente para informar capacidades, limitaciones y disclaimer del conector.

⚠️ 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 consultar_expediente

🛠️ 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-consulta-mcp
   • Type: command
   • Command: node
   • Args: D:/MCP/Legales/07-pjn-consulta-mcp/Argentina-PjnConsulta-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-consulta-mcp": {
      "command": "node",
      "args": ["D:/MCP/Legales/07-pjn-consulta-mcp/Argentina-PjnConsulta-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-consulta-mcp": {
      "command": "node",
      "args": ["D:/MCP/Legales/07-pjn-consulta-mcp/Argentina-PjnConsulta-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 07-pjn-consulta-mcp/Argentina-PjnConsulta-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 (16 Tools)

El servidor expone 16 herramientas (tools) diseñadas para consultar expedientes del PJN, con cobertura de 28 jurisdicciones y 40 tipos de partes.

Herramientas de Consulta

| Herramienta | Descripción | Parámetro principal | |---|---|---| | consultar_expediente | Consulta el estado de expedientes judiciales federales | criterio, captchaToken | | pjn_buscar_expediente_por_parte | Busca expedientes por nombre de partes (40 tipos) | party_name, jurisdiction_id, tipo_parte, captchaToken | | pjn_obtener_resoluciones_expediente | Obtiene resoluciones, autos y sentencias | expediente_id, captchaToken | | obtener_actuaciones | Lista las últimas actuaciones judiciales | criterio, captchaToken | | pjn_buscar_reparacion_historica | Busca reclamos de ANSES (jubilados y pensionados) | nombre, apellido, captchaToken | | pjn_buscar_gestion_documental | Busca documentos en Plataforma de Gestión Documental | keyword, dependencia, fecha_desde, fecha_hasta, captchaToken |

Herramientas de Descarga

| Herramienta | Descripción | Parámetro principal | |---|---|---| | pjn_descargar_documento_actuacion | Descarga PDF de actuación procesal | actuacion_id, captchaToken | | pjn_descargar_documento_gestion | Descarga documentos de Gestión Documental | documento_id, captchaToken |

Herramientas de Análisis y Relación

| Herramienta | Descripción | Parámetro principal | |---|---|---| | detector_plazos_judiciales | Detecta plazos y fechas límite en actuaciones | texto_actuaciones | | relacionar_expedientes | Busca expedientes 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 | actuacion_id, captchaToken | | exportar_expediente | Exporta a Markdown con frontmatter YAML | criterio, 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: consulta_expediente, auditar_expediente.

Parámetros detallados: TOOLS.md.

📝 Licencia

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