Servidor MCP de Avisos de Viaje de Canadá

Un servidor MCP para avisos de viaje del Gobierno de Canadá, respaldado por el índice de datos abiertos de Asuntos Globales de Canadá con 230 destinos.

Ligero por diseño: un único index.js, una dependencia (@modelcontextprotocol/sdk), sin paso de compilación, sin compilación de TypeScript, sin biblioteca HTTP.

Instalar

npm install

Requiere Node.js 18+ (usa el fetch integrado).

Related MCP server: Travel Assistant MCP

Configuración

No se necesita clave API — el conjunto de datos es público y no requiere autenticación. Todos los clientes a continuación ejecutan el mismo comando stdio: node <ruta>/index.js.

Sustituye tu propia ruta absoluta si el proyecto está en otro lugar.

Claude Code

claude mcp add canada-travel-advisory -- node E:/Claude/mcp-servers/canada-travel-advisory/index.js

Añade --scope user para que esté disponible en todos tus proyectos en lugar de solo en el actual.

Claude Desktop

En claude_desktop_config.json (Ajustes → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "canada-travel-advisory": {
      "command": "node",
      "args": ["E:/Claude/mcp-servers/canada-travel-advisory/index.js"]
    }
  }
}

Reinicia Claude Desktop después de guardar.

Codex CLI

codex mcp add canada-travel-advisory -- node E:/Claude/mcp-servers/canada-travel-advisory/index.js

O edita ~/.codex/config.toml directamente (usa .codex/config.toml en la raíz del proyecto para limitarlo a un proyecto de confianza):

[mcp_servers.canada-travel-advisory]
command = "node"
args = ["E:/Claude/mcp-servers/canada-travel-advisory/index.js"]

Verifica con codex mcp list.

Cursor

Crea .cursor/mcp.json en la raíz del proyecto, o ~/.cursor/mcp.json para habilitarlo globalmente:

{
  "mcpServers": {
    "canada-travel-advisory": {
      "command": "node",
      "args": ["E:/Claude/mcp-servers/canada-travel-advisory/index.js"]
    }
  }
}

El servidor aparece entonces en Ajustes → MCP, donde debe activarse.

Nota sobre rutas en Windows

Las barras inclinadas hacia adelante funcionan bien en Windows. Si prefieres barras invertidas en las configuraciones JSON, escápalas: "E:\\Claude\\mcp-servers\\canada-travel-advisory\\index.js".

Herramientas

Todas las herramientas aceptan language ("en" por defecto, o "fr"), que cambia los nombres, el texto del aviso y el enlace al destino entre travel.gc.ca y voyage.gc.ca.

Niveles de riesgo

min_risk_level: 2 devuelve todos los destinos a los que Canadá desaconseja viajar. Los filtros también aceptan el texto de la etiqueta (por ejemplo, risk_level: "Evitar todo viaje").

Ejemplos de preguntas que responde

• "¿Cuál es el aviso de viaje para Perú?"

• "¿Qué países debería evitar viajar ahora mismo?"

• "¿Qué avisos cambiaron en la última semana?"

• "Compara Japón, Malí y Francia para un viaje."

• "¿Cuántos destinos tienen avisos regionales?"

Fuente de datos y notas de comportamiento

Fuente: https://data.international.gc.ca/travel-voyage/index-alpha-eng.json

• Se obtiene un único endpoint, no dos. El publicado index-updated.json es idéntico byte a byte a index-alpha-eng.json (verificado: mismo MD5, mismo orden alfabético de claves) y en realidad no está ordenado por actualidad. Por lo tanto, get_recent_updates ordena localmente por date-published.timestamp, que es fiable independientemente del orden en que se encuentre el archivo upstream.

• Una sola consulta sirve para ambos idiomas. A pesar del sufijo -eng, cada registro incorpora bloques eng y fra; el archivo -fra solo difiere en el orden de las claves.

• Almacenamiento en caché: las respuestas se almacenan en caché en memoria durante 60 minutos (el conjunto de datos se regenera aproximadamente cada hora), actualizadas con solicitudes condicionales If-None-Match / If-Modified-Since. Si una actualización falla, se sirven los últimos datos válidos con stale: true en lugar de un error.

• Solo datos de resumen. El conjunto de datos contiene el nivel de riesgo, el texto del aviso, la fecha de actualización y el resumen del cambio. El detalle completo del aviso (seguridad y protección, requisitos de entrada, salud, desgloses regionales) solo existe como HTML, por lo que cada resultado incluye la url del destino para leerlo.

Cada respuesta también lleva data_generated (hora de generación upstream) y una línea de atribución de la fuente, para que las respuestas puedan fecharse.

Licencia

MIT. Datos de avisos © Gobierno de Canadá, utilizados bajo la Licencia de Gobierno Abierto – Canadá.