TCP Bolivia MCP V2.0 — Supreme One-Run Production Implementation

TCP Bolivia MCP V2.0 es el servidor oficial de protocolo Model Context Protocol (MCP) para la búsqueda, investigación, extracción de evidencia legal, análisis jurisprudencial y descarga verificada de resoluciones del Tribunal Constitucional Plurinacional (TCP) de Bolivia.

---

🚀 Novedades Principales en la Versión 2.0

• Arquitectura Modular TypeScript: Rediseño completo utilizando el SDK oficial @modelcontextprotocol/sdk de Anthropic sobre transporte stdio.
• Gobernador de Presupuesto de Tokens: Reducción drástica (~95%) del consumo de tokens en la ventana de chat mediante paquetes de evidencia compactos.
• Descubrimiento Completo de Aletheia API: Integración resiliente con firma criptográfica HMAC-SHA256, ordenamiento determinista de parámetros JSON y reintentos exponenciales con jitter.
• Diccionario Jurídico Boliviano Integrado: Expansión automática de consultas con términos equivalentes (debida motivación, anticresis, verdad material, non bis in idem).
• Referencias Reproducibles e Inmutables: Generación de identificadores estables por párrafo (tcp:{resolucionId}:{sectionSlug}:p{paragraphNumber}).
• Formato Estándar MCPB: Distribución mediante paquete bundle .mcpb para instalación con un solo clic.

---

📦 Instalación Rápida

Opción A: Paquete MCPB (Claude Desktop)

1. Descarga el paquete tcp-bolivia-mcp-v2.0.0.mcpb desde artifacts/tcp-bolivia-mcp-v2/.
2. Abre Claude Desktop, navega a Configuración > Servidores MCP y selecciona Agregar desde archivo .mcpb.

Opción B: Script Automatizado

Windows (PowerShell):

.\artifacts\tcp-bolivia-mcp-v2\install-windows.ps1

macOS / Linux:

chmod +x ./artifacts/tcp-bolivia-mcp-v2/install-macos-linux.sh
./artifacts/tcp-bolivia-mcp-v2/install-macos-linux.sh

---

🛠️ Herramientas Públicas

• tcp_investigar_jurisprudencia: Investigación y aplicación de jurisprudencia (Activación automática).
• tcp_buscar_resoluciones: Búsqueda precisa por número, gestión, partes o materias.
• tcp_obtener_evidencia: Extracción de extractos y citas con referencias reproducibles.
• tcp_ampliar_contexto: Ampliación focalizada de párrafos o secciones específicas.
• tcp_verificar_cita: Verificación de autenticidad de citas contra la base oficial del TCP.
• tcp_obtener_documento: Obtención de metadatos, descarga de PDF oficial o texto completo bajo demanda.
• tcp_estado: Diagnóstico de salud, estado de red y estadísticas de caché.

---

📊 Diagnóstico y Verificación

Para verificar la conectividad con Aletheia y la validez criptográfica en tu equipo:

npm run doctor

Para correr las pruebas unitarias e integración:

npm run test

Para ejecutar el benchmark de presupuesto de tokens:

npm run benchmark

---

📚 Documentación Técnica Completa

• Arquitectura del Sistema
• Descubrimiento Aletheia API
• Estrategia de Optimización de Tokens
• Reporte de Benchmarks
• Guía de Instalación Claude Desktop
• Guía para Proyectos de Claude
• Guía de Migración V1 a V2

---

📄 Licencia

Este proyecto está bajo la Licencia MIT.