normativapba-mcp

# Argentina Normativa PBA - MCP Server [](https://www.npmjs.com/package/normativapba-mcp) [](https://www.typescriptlang.org/) [](https://modelcontextprotocol.io/) 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](https://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](https://nodejs.org/) 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: ```json { "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: ```bash claude mcp add normativa-pba npx -y normativapba-mcp ``` ### 4. Antigravity / Codex Agrega el servidor en tu archivo `mcp_config.json`: ```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](TOOLS.md).** --- ## 📝 Licencia Este proyecto está bajo la Licencia MIT - mira el archivo [LICENSE](LICENSE) para más detalles.