TCP Bolivia Server

Version MCP Protocol License

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.