TRANSCEND MCP

Servidor MCP de optimización de rutas impulsado por IA para vehículos pesados y logística. Calcula rutas optimizadas para camiones, predice la congestión del tráfico con redes neuronales LSTM, calcula costos de peaje, costos de combustible y emisiones de CO2, encuentra paradas para camiones y consulta el clima a lo largo de cualquier ruta europea. Construido sobre el motor de enrutamiento Valhalla.

GitHubPrueba este MCPPatrocinado

Documentación

Capa MCP operativa para la inteligencia del transporte por carretera europeo

Un servidor MCP de optimización de rutas que conecta agentes de IA (Claude Desktop, Cline, Continue, Cursor, etc.) con la plataforma de inteligencia logística TRANSCEND — proporcionando a los LLM acceso en tiempo real a la optimización de rutas de camiones, costes de peajes, meteorología, aparcamiento, puntos negros de tráfico y precios de estaciones de combustible en España y Europa.

¿Qué problema resuelve? Los operadores de logística de camiones pierden horas alternando entre Google Maps (que no tiene en cuenta las restricciones de camiones), sitios web de peajes, aplicaciones meteorológicas y hojas de cálculo de precios de combustible. Este servidor MCP consolida 6 fuentes de datos logísticos en tiempo real en una única interfaz invocable por IA, de modo que los agentes puedan planificar rutas, estimar costes y evaluar riesgos en un solo paso.

¿Qué lo hace diferente? A diferencia de las API de mapas genéricas, TRANSCEND está diseñado específicamente para las necesidades de logística de camiones en Europa — respeta las restricciones ADR (mercancías peligrosas), los límites de altura/ancho/peso de camiones, ofrece desgloses de peajes por segmento con costes de combustible y CO₂, identifica zonas de puntos negros peligrosos y localiza aparcamientos específicos para camiones. Es la única interfaz MCP unificada para la infraestructura logística de carreteras europeas.

¿Qué integración permite? Cualquier cliente compatible con MCP puede invocar 12 herramientas de inteligencia logística que cubren optimización de rutas, estimación de costes de peajes, condiciones meteorológicas, aparcamiento POI, análisis de puntos negros de tráfico y precios de estaciones de combustible — todo desde una sola conversación con un LLM.

¿Qué significa "integración sencilla" en concreto? pip install el paquete, establece TRANSCEND_API_KEY y añade un bloque de configuración JSON a Claude Desktop. Sin orquestación de microservicios, sin gestión de múltiples claves API, sin middleware personalizado. Tu asistente de IA obtiene acceso instantáneo a automatización de documentos logísticos profesional e inteligencia de rutas europea.

Por qué existe este MCP

La planificación de rutas de camiones en Europa está fragmentada. Google Maps no conoce las restricciones de altura de camiones. Las calculadoras de peajes son específicas de cada país. Las alertas meteorológicas provienen de una tercera fuente. Los precios del combustible cambian cada hora. Los despachadores manejan manualmente más de 5 pestañas para responder a una sola pregunta como "¿cuál es la ruta más segura y económica de Madrid a Frankfurt para un camión frigorífico de 4 m de altura?"

Este servidor MCP agrega seis microservicios de la API de TRANSCEND (Ruta, Peajes, Meteorología, POI, Tráfico, Estaciones) detrás de una única interfaz MCP — haciendo que los datos de transporte por carretera europeo sean accesibles para los agentes de IA a través del lenguaje natural. Transforma al agente de una interfaz de chat a un copiloto logístico operativo.

Capacidades del MCP

12 herramientas MCP en 6 módulos logísticos — organizadas por dominio, no ocultas en código
Optimización de rutas consciente de camiones con restricciones de clase ADR, dimensiones del vehículo y límites de peso
Desglose completo de costes — peajes + consumo de combustible + mantenimiento + emisiones de CO₂ por ruta
Meteorología en tiempo real — condiciones actuales, pronósticos de varios días y alertas meteorológicas activas a lo largo de un corredor
Búsqueda de POI de aparcamiento para camiones — por coordenadas, código postal o provincia (con capacidad y servicios)
Identificación de puntos negros de tráfico — zonas de carretera peligrosas a lo largo de una ruta planificada
Localizador de estaciones de combustible — estaciones cercanas, búsqueda filtrada y clasificación por mejor precio
Configuración consciente del entorno — URLs separadas para entornos de producción vs. desarrollo/lanzamiento
Transportes HTTP/SSE y stdio — funciona con todos los clientes MCP sin configuración adicional
Entradas y salidas validadas con Pydantic — Python 3.10+, cliente asíncrono httpx

Herramientas

Módulo	Herramienta	Descripción
🗺️ Ruta	`calculate_route`	Ruta de camión optimizada con restricciones de ADR, altura, anchura y peso
💰 Peajes	`calculate_route_costs`	Estimación de costes de combustible + peajes + mantenimiento + CO₂
🌤️ Meteorología	`get_current_weather`	Meteorología en tiempo real en una ubicación
	`get_weather_forecast`	Pronóstico para un rango de fechas
	`get_weather_alerts`	Avisos meteorológicos activos
🅿️ POI	`find_parking_by_location`	Aparcamiento de camiones cerca de coordenadas
	`find_parking_by_zipcode`	Aparcamiento por código postal
	`find_parking_by_province`	Aparcamiento por provincia
🛑 Tráfico	`get_blackspots_path`	Zonas peligrosas a lo largo de una ruta
⛽ Estaciones	`find_stations_nearby`	Estaciones de combustible cerca de coordenadas
	`search_stations`	Filtrar estaciones por tipo de combustible, búsqueda de texto
	`get_station_best_prices`	Mejores precios de combustible cerca de una ubicación

Estructura de directorios

transcend-mcp-server/
├── pyproject.toml                  # Python 3.10+, dependencies: mcp, httpx, pydantic
├── src/transcend_mcp/
│   ├── server.py                   # FastMCP server bootstrap (stdio / HTTP/SSE)
│   ├── client.py                   # Multi-service HTTP client (6 backend APIs)
│   ├── config.py                   # Environment-aware URL resolution (prod / release-dev)
│   ├── tools.py                    # 12 MCP tool definitions with pydantic schemas
│   ├── __init__.py                 # Package init
│   └── __main__.py                 # Entry point for `python -m transcend_mcp`
└── tests/
    └── test_client.py              # Integration tests for client.py

Autenticación

Para usar este servidor MCP, necesitas una clave API de la plataforma TRANSCEND.

Registro: https://transcend.cargoffer.com

Crea una cuenta y obtén tu clave API desde la configuración de tu perfil. Luego configura:

export TRANSCEND_API_KEY="your-api-key"

O en la configuración de tu cliente MCP:

{
  "mcpServers": {
    "transcend": {
      "command": "...",
      "env": {
        "TRANSCEND_API_KEY": "your-api-key-from-transcend"
      }
    }
  }
}

Inicio rápido

git clone https://github.com/cargoffer/transcend-mcp-server.git
cd transcend-mcp-server
pip install -e .
export TRANSCEND_API_KEY="your-api-key"
python -m transcend_mcp

Por defecto se ejecuta en stdio (transporte MCP). Establece MCP_HOST / MCP_PORT para el modo HTTP/SSE.

Instalación

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "transcend": {
      "command": "python",
      "args": ["-m", "transcend_mcp"],
      "env": {
        "TRANSCEND_API_KEY": "your-api-key",
        "TRANSCEND_ENV": "production"
      }
    }
  }
}

Cursor

Cursor Settings → Features → MCP Servers → Add New:

Name:   transcend
Type:   command
Command: python -m transcend_mcp
Env:    TRANSCEND_API_KEY=your-api-key, TRANSCEND_ENV=production

HTTP / SSE directo

export MCP_HOST=0.0.0.0
export MCP_PORT=8100
python -m transcend_mcp

# Then connect SSE at http://localhost:8100/sse

Protocolo MCP en acción

Calcular una ruta de camión optimizada:

# With stdio transport, use any MCP client. For HTTP/SSE mode:
# First, connect to SSE endpoint, then send JSON-RPC messages

# Example using the JSON-RPC format over SSE (after establishing connection):
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "calculate_route",
  "params": {
    "origin": "Vigo, Spain",
    "destination": "Barcelona, Spain",
    "dimensions": {
      "height": 4.0,
      "width": 2.55,
      "weight": 40000,
      "adr_class": null
    }
  }
}

Obtener costes de ruta con datos reales de peajes:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "calculate_route_costs",
  "params": {
    "route_id": "route_abc_123",
    "fuel_consumption": 35,
    "fuel_type": "diesel",
    "include_co2": true
  }
}

Encontrar aparcamiento de camiones a lo largo de la ruta:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "find_parking_by_location",
  "params": {
    "latitude": 41.6488,
    "longitude": -0.8891,
    "radius_km": 10
  }
}

Ejemplos de prompts para agentes de IA

"Calcula una ruta de camión optimizada de Vigo a Barcelona. El camión tiene 4 m de alto, 2,55 m de ancho, 40 toneladas. Incluye avisos de puntos negros."

"¿Cuál es el coste total de una carga de 15 toneladas de Madrid a Valencia con un consumo medio de combustible de 35 L/100 km usando diésel?"

"Encuentra aparcamiento de camiones cerca de la Plaza España en Zaragoza."

"¿Qué estaciones de combustible hay cerca de la autopista A-2 en Guadalajara? Muéstrame los mejores precios."

"¿Hay alguna zona peligrosa en la ruta de Sevilla a Málaga?"

"¿Cuál es el pronóstico meteorológico a lo largo de la A-3 de Madrid a Valencia para mañana? ¿Hay alguna alerta?"

Configuración

Variables de entorno

Variable	Requerida	Predeterminado	Descripción
`TRANSCEND_API_KEY`	✔	—	Tu clave API de TRANSCEND
`TRANSCEND_ENV`		`production`	`production` o `release-dev`
`LOG_LEVEL`		`INFO`	Nivel de detalle del registro
`MCP_HOST`		`localhost`	Dirección de enlace HTTP/SSE
`MCP_PORT`		`8100`	Puerto HTTP/SSE

URLs de microservicios de producción

Módulo	URL de producción
Peajes	`https://back.transcend.cargoffer.com/transcend/tolls`
POI	`https://back.transcend.cargoffer.com/transcend/poi`
Estaciones	`https://back.transcend.cargoffer.com/transcend/stations`
Meteorología	`https://back.transcend.cargoffer.com/transcend/weather`
Tráfico	`https://back.transcend.cargoffer.com/transcend/traffic`

Desarrollo

pip install -e ".[dev]"
pytest
ruff check src/
ruff format src/

Etiquetas semánticas

route optimization MCP truck logistics API MCP server Model Context Protocol European road transport logistics document automation TRANSCEND truck routing toll calculator fuel prices truck parking weather alerts traffic blackspots ADR restrictions CO2 emissions AI agents LLM tools supply chain Spain logistics Cargoffer easy MCP integration

Licencia

MIT — consulta el archivo LICENSE para más detalles.

Enlaces

Repositorio: github.com/cargoffer/transcend-mcp-server
Incidencias: github.com/cargoffer/transcend-mcp-server/issues
Protocolo MCP: modelcontextprotocol.io