# MI PANA APP - MCP Server

Servidor MCP (Model Context Protocol) para gestión de viajes, conductores y tarifas de MI PANA APP.

## 🚀 Características

- **Búsqueda de conductores** disponibles por ubicación y radio
- **Cálculo de tarifas** dinámicas basadas en distancia y tiempo
- **Gestión de viajes** (crear, actualizar, completar)
- **Seguimiento en tiempo real** de ubicación de conductores
- **Estadísticas de conductores** por período
- **Cálculo de distancias** usando fórmula de Haversine

## 📋 Herramientas Disponibles

### 1. `buscar_conductores_disponibles`
Busca conductores disponibles en un radio específico.

**Parámetros:**
- `latitud` (number): Latitud del punto de búsqueda
- `longitud` (number): Longitud del punto de búsqueda
- `radio_km` (number, opcional): Radio de búsqueda en km (default: 5)

### 2. `crear_viaje`
Crea una nueva solicitud de viaje.

**Parámetros:**
- `user_id` (string): ID del usuario
- `origen` (object): { latitud, longitud, direccion }
- `destino` (object): { latitud, longitud, direccion }
- `metodo_pago` (string): efectivo | transferencia | pago_movil

### 3. `calcular_tarifa`
Calcula la tarifa estimada de un viaje.

**Parámetros:**
- `distancia_km` (number): Distancia en kilómetros
- `duracion_min` (number, opcional): Duración en minutos
- `tipo_servicio` (string, opcional): mototaxi | el_pana | el_amigo | full_pana
- `moneda` (string, opcional): BS | USD

### 4. `actualizar_ubicacion_conductor`
Actualiza la ubicación en tiempo real de un conductor.

**Parámetros:**
- `conductor_id` (string): ID del conductor
- `latitud` (number): Latitud actual
- `longitud` (number): Longitud actual
- `rumbo` (number, opcional): Dirección en grados (0-360)

### 5. `obtener_estadisticas_conductor`
Obtiene estadísticas de rendimiento de un conductor.

**Parámetros:**
- `conductor_id` (string): ID del conductor
- `periodo` (string, opcional): today | week | month | all_time

### 6. `completar_viaje`
Marca un viaje como completado y calcula la tarifa final.

**Parámetros:**
- `viaje_id` (string): ID del viaje
- `distancia_real_km` (number): Distancia real recorrida
- `duracion_real_min` (number): Duración real del viaje
- `calificacion` (number, opcional): Calificación 1-5

### 7. `calcular_distancia`
Calcula la distancia entre dos puntos geográficos.

**Parámetros:**
- `origen` (object): { latitud, longitud }
- `destino` (object): { latitud, longitud }

## 🛠️ Instalación Local

```bash
# Instalar dependencias
npm install

# Configurar variables de entorno
cp .env.example .env
# Editar .env con tus credenciales de Supabase

# Ejecutar en desarrollo
npm run dev

# Ejecutar en producción
npm start
```

## 🚀 Despliegue en Vercel

### Opción 1: Desde GitHub

1. Sube el código a un repositorio de GitHub
2. Importa el proyecto en Vercel
3. Configura las variables de entorno en Vercel:
   - `SUPABASE_URL`
   - `SUPABASE_SERVICE_KEY`
   - `BASE_FARE_BS`
   - `PER_KM_BS`
   - `PER_MIN_BS`
   - `MIN_FARE_BS`
   - `USD_EXCHANGE_RATE`
   - `FUEL_PRICE_BS`

### Opción 2: Desde CLI

```bash
# Instalar Vercel CLI
npm i -g vercel

# Desplegar
vercel

# Configurar variables de entorno
vercel env add SUPABASE_URL
vercel env add SUPABASE_SERVICE_KEY
# ... (agregar todas las variables)

# Redesplegar con las variables
vercel --prod
```

## 🔗 Configuración en Manus

Una vez desplegado en Vercel:

1. Obtén la URL de tu despliegue (ej: `https://mipanaapp-mcp.vercel.app`)
2. En Manus, ve a **Settings → Conectores**
3. Edita el conector "MI PANA APP - Gestión de Viajes"
4. Actualiza la URL a: `https://tu-proyecto.vercel.app/mcp`
5. Guarda los cambios

## 📊 Estructura del Proyecto

```
mipanaapp-mcp/
├── api/
│   └── mcp.js              # Endpoint para Vercel (SSE)
├── src/
│   ├── index.js            # Servidor principal (stdio)
│   ├── handlers/           # (Futuro: handlers específicos)
│   └── utils/
│       ├── distance.js     # Cálculos de distancia
│       └── fare-calculator.js  # Cálculo de tarifas
├── package.json
├── vercel.json
├── .env.example
└── README.md
```

## 🧪 Pruebas

Ejemplos de uso con Manus:

```
"Busca conductores disponibles cerca de Acarigua (latitud: 9.5549, longitud: -69.1952)"

"Calcula la tarifa para un viaje de 10 kilómetros"

"Calcula la distancia entre Caracas (10.4806, -66.9036) y Maracay (10.2469, -67.5958)"
```

## 📝 Notas

- El servidor usa **Supabase** como base de datos
- Las tarifas se calculan en **Bolívares (BS)** y pueden convertirse a **USD**
- La velocidad promedio asumida es **20 km/h** para cálculos de ETA
- El servidor soporta tanto **stdio** (para uso local) como **SSE** (para Vercel)

## 🔒 Seguridad

- Nunca compartas tu `SUPABASE_SERVICE_KEY` públicamente
- Usa variables de entorno para todas las credenciales
- El service_role key tiene permisos completos en Supabase

## 📄 Licencia

MIT

## 👤 Autor

Carlos Depool - MI PANA APP