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

[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](https://github.com/israelmamani/tcp-bolivia-mcp)
[![MCP Protocol](https://img.shields.io/badge/MCP-SDK--1.5-green.svg)](https://modelcontextprotocol.io)
[![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](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/](artifacts/tcp-bolivia-mcp-v2/tcp-bolivia-mcp-v2.0.0.mcpb).
2. Abre Claude Desktop, navega a **Configuración > Servidores MCP** y selecciona **Agregar desde archivo .mcpb**.

### Opción B: Script Automatizado

#### Windows (PowerShell):
```powershell
.\artifacts\tcp-bolivia-mcp-v2\install-windows.ps1
```

#### macOS / Linux:
```bash
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:

```bash
npm run doctor
```

Para correr las pruebas unitarias e integración:

```bash
npm run test
```

Para ejecutar el benchmark de presupuesto de tokens:

```bash
npm run benchmark
```

---

## 📚 Documentación Técnica Completa

- [Arquitectura del Sistema](docs/ARCHITECTURE.md)
- [Descubrimiento Aletheia API](docs/ALETHEIA_API_DISCOVERY.md)
- [Estrategia de Optimización de Tokens](docs/TOKEN_STRATEGY.md)
- [Reporte de Benchmarks](docs/BENCHMARK_REPORT.md)
- [Guía de Instalación Claude Desktop](docs/INSTALL_CLAUDE_DESKTOP.md)
- [Guía para Proyectos de Claude](docs/CLAUDE_PROJECT_INSTRUCTIONS.md)
- [Guía de Migración V1 a V2](MIGRATION_V1_TO_V2.md)

---

## 📄 Licencia

Este proyecto está bajo la Licencia MIT.