Argentina Normativa PBA - MCP Server

Servidor MCP (Model Context Protocol) para consulta en tiempo real de la normativa oficial de la Provincia de Buenos Aires. Conecta cualquier LLM compatible (Claude, Cursor, Antigravity) con el portal oficial normas.gba.gob.ar para buscar leyes, decretos, resoluciones y disposiciones, verificar su vigencia y extraer el articulado completo con fidelidad jurídica sin alucinaciones.

🚀 Características Principales

• Conector Automático: Busca leyes directamente por número y año sin requerir la URL.
• Fidelidad Absoluta: Extrae los textos directamente de la fuente oficial preservando estructura y formato, mitigando alucinaciones del LLM.
• Árboles de Dependencia: Analiza leyes y extrae aquellas que la modifican, derogan o reglamentan.
• Búsqueda Semántica: Soporte para expansión de términos a través del LLM, buscando leyes equivalentes por significado.

🛠️ Instalación Rápida (Recomendado)

La forma más sencilla de utilizar este servidor es a través de npx, lo que evita tener que descargar código o compilar nada. Solo necesitas tener Node.js instalado en tu computadora.

A continuación, te mostramos cómo configurarlo en tu cliente favorito de Inteligencia Artificial:

1. Cursor IDE / Windsurf

Tanto Cursor como Windsurf soportan MCP de forma nativa:

1. Abre la configuración (Settings) y busca la sección MCP.
2. Haz clic en + Add New MCP Server.
3. Completa los datos:
   • Name: normativa-pba
   • Type: command
   • Command: npx -y normativapba-mcp

2. Claude Desktop

1. Abre tu archivo de configuración de Claude. En Windows, normalmente está en: C:\Users\<TuUsuario>\AppData\Roaming\Claude\claude_desktop_config.json
2. Agrega este código dentro del archivo:

{
  "mcpServers": {
    "normativa-pba": {
      "command": "npx",
      "args": ["-y", "normativapba-mcp"],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

💡 Nota sobre Seguridad SSL: La línea NODE_TLS_REJECT_UNAUTHORIZED soluciona los errores comunes de certificados de seguridad vencidos en las páginas gubernamentales.

3. Claude CLI / Claude Code

Si usas la línea de comandos de Claude, simplemente ejecuta:

claude mcp add normativa-pba npx -y normativapba-mcp

4. Antigravity / Codex

Agrega el servidor en tu archivo mcp_config.json:

{
  "mcpServers": {
    "normativa-pba": {
      "command": "npx",
      "args": ["-y", "normativapba-mcp"]
    }
  }
}

💻 Instalación Manual (Para Desarrolladores)

Si prefieres descargar el código fuente y correrlo localmente:

1. Clona este repositorio: git clone https://github.com/voftec/normativapba-mcp.git
2. Instala las dependencias: npm install
3. Compila el código: npm run build
4. En tu cliente MCP (Cursor, Claude), en vez de npx, usa el comando local: node /ruta/a/tu/carpeta/build/index.js

⚖️ Herramientas Disponibles (Tools)

El servidor expone 9 herramientas especializadas orquestadas para simular el trabajo de un investigador jurídico:

1. buscar_normativa: Busca leyes por parámetros exactos.
2. verificar_vigencia: Comprueba si la ley sigue activa o fue derogada. (Autoresolución por número/año).
3. obtener_articulo: Extrae solo el artículo solicitado (ej. "Art. 5 bis").
4. obtener_texto_norma: Descarga el texto íntegro de la norma. (Autoresolución por número/año).
5. alcance_normativo: Informa al LLM la jurisdicción y metadatos de este servidor.
6. exportar_norma: Genera un Markdown estructurado con Frontmatter YAML para Notion/Obsidian.
7. relacionar_normativa: Construye el árbol de dependencias legales (qué deroga, qué modifica).
8. buscar_por_semantica: Usa expansión de sinónimos del LLM para búsquedas amplias de conceptos.
9. mapa_normativo_tema: Genera un árbol jerárquico (Leyes → Decretos → Resoluciones) de un tema específico.

👉 Para ver la documentación técnica de cada herramienta, consulta el archivo TOOLS.md.

📝 Licencia

Este proyecto está bajo la Licencia MIT - mira el archivo LICENSE para más detalles.