baliza16mcp

Servidor MCP oficial de balizame.com para datos en tiempo real de balizas V16 activas en Espana.

Conecta Claude y otros LLMs con datos de balizas V16, obteniendo las ubicaciones de vehiculos detenidos/averiados que estan transmitiendo su posicion mediante balizas V16 conectadas.

Caracteristicas

• Datos en tiempo real: Actualizacion cada minuto
• Filtrado inteligente: Solo muestra incidentes tipo vehicleObstruction (balizas V16 activas)
• Cobertura nacional: Todas las balizas V16 conectadas en Espana
• Informacion completa: Coordenadas GPS, carretera, km, municipio, provincia, severidad
• Cache inteligente: Minimiza llamadas al servidor respetando la frecuencia de actualizacion

Instalacion

Opcion 1: npx (recomendado)

No necesitas instalar nada, usalo directamente:

npx baliza16mcp

Opcion 2: Instalacion global

npm install -g baliza16mcp

Opcion 3: Desde codigo fuente

git clone https://github.com/granerodev/baliza16mcp.git
cd baliza16mcp
npm install
npm run build

Configuracion en Claude Desktop

Anade a tu archivo de configuracion claude_desktop_config.json:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Configuracion

{
  "mcpServers": {
    "balizas-v16": {
      "command": "npx",
      "args": ["-y", "baliza16mcp"]
    }
  }
}

O si lo instalaste globalmente:

{
  "mcpServers": {
    "balizas-v16": {
      "command": "baliza16mcp"
    }
  }
}

Reinicia Claude Desktop despues de modificar la configuracion.

Herramientas disponibles

obtener_balizas_activas

Obtiene las balizas V16 actualmente activas en Espana.

Parametros (todos opcionales):

| Parametro | Tipo | Descripcion | |-----------|------|-------------| | provincia | string | Filtrar por provincia (ej: "Madrid", "Barcelona") | | carretera | string | Filtrar por carretera (ej: "A-1", "AP-7") | | severidad | string | Filtrar por severidad: "baja", "media", "alta", "critica" | | limite | number | Numero maximo de resultados |

Ejemplo de uso en Claude:

"Cuantas balizas V16 hay activas en Madrid ahora mismo?"

Respuesta:

{
  "fuente": "balizame.com",
  "actualizadoEn": "2026-01-16T17:00:00.000Z",
  "totalEncontradas": 33,
  "totalEspana": 322,
  "balizas": [
    {
      "id": "v16-8355636",
      "coordenadas": { "lat": 40.416775, "lon": -3.703790 },
      "ubicacion": {
        "nombreCarretera": "A-6",
        "km": 15.2,
        "municipio": "Las Rozas",
        "provincia": "Madrid",
        "comunidadAutonoma": "Madrid"
      },
      "incidente": {
        "tipo": "vehiculo_detenido",
        "severidad": "baja",
        "horaInicio": "2026-01-16T16:45:00.000+01:00"
      }
    }
  ]
}

estadisticas_balizas

Obtiene estadisticas agregadas de las balizas V16 activas.

Ejemplo de uso en Claude:

"Dame estadisticas de las balizas V16 activas en Espana"

Respuesta:

{
  "estadisticas": {
    "totalBalizasActivas": 322,
    "porProvincia": {
      "Madrid": 33,
      "Valencia": 22,
      "Alicante": 22,
      "A Coruna": 20
    },
    "porSeveridad": {
      "baja": 317,
      "critica": 3,
      "alta": 1,
      "media": 1
    }
  }
}

Recurso MCP

El servidor tambien expone un recurso MCP:

• URI: balizas://activas
• Descripcion: Listado completo de balizas V16 activas en formato JSON

Que son las balizas V16?

Las balizas V16 son dispositivos de senalizacion luminosa de emergencia que sustituyen a los triangulos de emergencia en Espana. Las balizas V16 conectadas (IoT) transmiten automaticamente su posicion GPS cuando se activan, permitiendo:

• Alertar a otros conductores a traves de sistemas de navegacion
• Mejorar la respuesta de servicios de emergencia
• Reducir el riesgo de atropellos en carretera

Mas informacion: balizame.com

Desarrollo

# Clonar repositorio
git clone https://github.com/granerodev/baliza16mcp.git
cd baliza16mcp

# Instalar dependencias
npm install

# Desarrollo con hot-reload
npm run dev

# Compilar
npm run build

# Probar con MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

Licencia

MIT - Libre para uso personal y comercial.

Problemas o sugerencias? Abre un issue