TRANSCEND MCP

Servidor MCP de otimização de rotas com IA para veículos pesados e logística. Calcule rotas otimizadas para caminhões, preveja congestionamentos de tráfego com redes neurais LSTM, calcule custos de pedágio, combustível e emissões de CO2, encontre paradas para caminhões e verifique o clima ao longo de qualquer rota europeia. Construído sobre o mecanismo de roteamento Valhalla.

GitHubExperimente este MCPPatrocinado

Documentação

Camada MCP operacional para inteligência de transporte rodoviário europeu

Um servidor MCP de otimização de rotas que conecta agentes de IA (Claude Desktop, Cline, Continue, Cursor, etc.) à plataforma de inteligência logística TRANSCEND — dando aos LLMs acesso em tempo real à otimização de rotas de caminhões, custos de pedágio, clima, estacionamento, pontos críticos de tráfego e preços de postos de combustível na Espanha e na Europa.

Que problema ele resolve? Operadores de logística de caminhões perdem horas alternando entre Google Maps (que não considera restrições de caminhões), sites de pedágio, aplicativos de clima e planilhas de preços de combustível. Este servidor MCP consolida 6 fontes de dados logísticos em tempo real em uma única interface chamável por IA, para que agentes possam planejar rotas, estimar custos e avaliar riscos em uma única etapa.

O que o torna diferente? Diferente de APIs de mapeamento genéricas, a TRANSCEND é construída especificamente para as necessidades de API de logística de caminhões europeus — ela respeita restrições ADR (mercadorias perigosas), limites de altura/largura/peso de caminhões, fornece detalhamentos de pedágio por segmento com custos de combustível e CO₂, identifica zonas de risco perigosas e localiza estacionamentos específicos para caminhões. É a única interface MCP unificada para a infraestrutura de logística rodoviária europeia.

Que integração ela permite? Qualquer cliente compatível com MCP pode invocar 12 ferramentas de inteligência logística cobrindo otimização de rotas, estimativa de custos de pedágio, condições climáticas, estacionamento POI, análise de pontos críticos de tráfego e preços de postos de combustível — tudo a partir de uma única conversa com um LLM.

O que "integração fácil" significa concretamente? pip install o pacote, defina TRANSCEND_API_KEY e adicione um bloco de configuração JSON ao Claude Desktop. Sem orquestração de microsserviços, sem gerenciamento de múltiplas chaves de API, sem middleware personalizado. Seu assistente de IA ganha acesso instantâneo à automação profissional de documentos logísticos europeus e à inteligência de rotas.

Por que este MCP existe

O planejamento de rotas de caminhões na Europa é fragmentado. O Google Maps não conhece restrições de altura para caminhões. Calculadoras de pedágio são por país. Alertas climáticos vêm de uma terceira fonte. Preços de combustível mudam a cada hora. Despachantes alternam manualmente entre 5+ abas para responder a uma única pergunta como "qual é a rota mais segura e barata de Madri a Frankfurt para um caminhão refrigerado de 4m de altura?"

Este servidor MCP agrega seis microsserviços da API TRANSCEND (Route, Tolls, Weather, POI, Traffic, Stations) atrás de uma única interface MCP — tornando os dados de transporte rodoviário europeu acessíveis a agentes de IA por meio de linguagem natural. Ele transforma o agente de uma interface de chat em um copiloto logístico operacional.

Recursos do MCP

12 ferramentas MCP em 6 módulos logísticos — organizadas por domínio, não escondidas em código
Otimização de rotas consciente de caminhões com restrições de classe ADR, dimensões do veículo e limites de peso
Detalhamento completo de custos — pedágios + consumo de combustível + manutenção + emissões de CO₂ por rota
Clima em tempo real — condições atuais, previsões de vários dias e alertas climáticos ativos ao longo de um corredor
Busca de POI de estacionamento para caminhões — por coordenadas, código postal ou província (com capacidade e comodidades)
Identificação de pontos críticos de tráfego — zonas rodoviárias perigosas ao longo de uma rota planejada
Localizador de postos de combustível — postos próximos, busca filtrada e ranking de melhores preços
Configuração consciente do ambiente — URLs separadas para ambientes de produção vs. desenvolvimento/versão
Transportes HTTP/SSE e stdio — funciona com todos os clientes MCP de fábrica
Entradas e saídas validadas por Pydantic — Python 3.10+, cliente assíncrono httpx

Ferramentas

Módulo	Ferramenta	Descrição
🗺️ Route	`calculate_route`	Rota otimizada para caminhões com restrições de ADR, altura, largura e peso
💰 Tolls	`calculate_route_costs`	Estimativa de custos de combustível + pedágios + manutenção + CO₂
🌤️ Weather	`get_current_weather`	Clima em tempo real em um local
	`get_weather_forecast`	Previsão para um intervalo de datas
	`get_weather_alerts`	Alertas climáticos ativos
🅿️ POI	`find_parking_by_location`	Estacionamento para caminhões próximo a coordenadas
	`find_parking_by_zipcode`	Estacionamento por código postal
	`find_parking_by_province`	Estacionamento por província
🛑 Traffic	`get_blackspots_path`	Zonas perigosas ao longo de uma rota
⛽ Stations	`find_stations_nearby`	Postos de combustível próximos a coordenadas
	`search_stations`	Filtrar postos por tipo de combustível, busca por texto
	`get_station_best_prices`	Melhores preços de combustível próximos a um local

Estrutura de diretórios

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

Autenticação

Para usar este servidor MCP, você precisa de uma chave de API da plataforma TRANSCEND.

Registre-se: https://transcend.cargoffer.com

Crie uma conta e obtenha sua chave de API nas configurações do seu perfil. Em seguida, configure:

export TRANSCEND_API_KEY="your-api-key"

Ou na configuração do seu cliente MCP:

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

Início 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 padrão, executa em stdio (transporte MCP). Defina MCP_HOST / MCP_PORT para o modo HTTP/SSE.

Instalação

Claude Desktop

Adicione a claude_desktop_config.json:

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

Cursor

Configurações do Cursor → Recursos → Servidores MCP → Adicionar Novo:

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

HTTP / SSE direto

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 em ação

Calcule uma rota otimizada para caminhões:

# 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
    }
  }
}

Obtenha custos de rota com dados reais de pedágio:

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

Encontre estacionamento para caminhões ao longo da rota:

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

Exemplos de Prompts para Agentes de IA

"Calcule uma rota otimizada para caminhões de Vigo a Barcelona. O caminhão tem 4m de altura, 2,55m de largura, 40 toneladas. Inclua alertas de pontos críticos."

"Qual é o custo total de uma carga de 15 toneladas de Madri a Valência com consumo médio de combustível de 35L/100km usando diesel?"

"Encontre estacionamento para caminhões perto da Plaza España em Zaragoza."

"Quais postos de combustível estão perto da rodovia A-2 em Guadalajara? Mostre-me os melhores preços."

"Há alguma zona perigosa na rota de Sevilha a Málaga?"

"Qual é a previsão do tempo ao longo da A-3 de Madri a Valência para amanhã? Há algum alerta?"

Configuração

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
`TRANSCEND_API_KEY`	✔	—	Sua chave de API TRANSCEND
`TRANSCEND_ENV`		`production`	`production` ou `release-dev`
`LOG_LEVEL`		`INFO`	Nível de detalhamento de logs
`MCP_HOST`		`localhost`	Endereço de bind HTTP/SSE
`MCP_PORT`		`8100`	Porta HTTP/SSE

URLs de Microsserviços de Produção

Módulo	URL de Produção
Tolls	`https://back.transcend.cargoffer.com/transcend/tolls`
POI	`https://back.transcend.cargoffer.com/transcend/poi`
Stations	`https://back.transcend.cargoffer.com/transcend/stations`
Weather	`https://back.transcend.cargoffer.com/transcend/weather`
Traffic	`https://back.transcend.cargoffer.com/transcend/traffic`

Desenvolvimento

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

Tags 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

Licença

MIT — consulte o arquivo LICENSE para obter detalhes.