Canada Travel Advisory MCP Server

Ein MCP server für Reisehinweise der kanadischen Regierung, basierend auf dem Open-Data-Index von Global Affairs Canada mit 230 Reisezielen.

Leichtgewichtig von Grund auf: eine einzige index.js, eine Abhängigkeit (@modelcontextprotocol/sdk), kein Build-Schritt, kein TypeScript-Compile, keine HTTP-Bibliothek.

Installation

npm install

Erfordert Node.js 18+ (nutzt das eingebaute fetch).

Related MCP server: Travel Assistant MCP

Einrichtung

Es wird kein API-Schlüssel benötigt – der Datensatz ist öffentlich und ohne Authentifizierung. Alle unten aufgeführten Clients führen denselben stdio-Befehl aus: node <path-to>/index.js.

Ersetzen Sie den Pfad durch Ihren eigenen absoluten Pfad, falls das Projekt woanders liegt.

Claude Code

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

Fügen Sie --scope user hinzu, um es für alle Ihre Projekte verfügbar zu machen, nicht nur für das aktuelle.

Claude Desktop

In claude_desktop_config.json (Einstellungen → Entwickler → Konfiguration bearbeiten):

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

Starten Sie Claude Desktop nach dem Speichern neu.

Codex CLI

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

Oder bearbeiten Sie ~/.codex/config.toml direkt (verwenden Sie .codex/config.toml im Projektstammverzeichnis, um es auf ein vertrauenswürdiges Projekt zu beschränken):

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

Überprüfen Sie mit codex mcp list.

Cursor

Erstellen Sie .cursor/mcp.json im Projektstammverzeichnis oder ~/.cursor/mcp.json, um es global zu aktivieren:

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

Der Server erscheint dann unter Einstellungen → MCP, wo er aktiviert werden muss.

Hinweis zu Windows-Pfaden

Die obigen Schrägstriche funktionieren unter Windows einwandfrei. Wenn Sie in den JSON-Konfigurationen lieber Backslashes verwenden, maskieren Sie diese: "E:\\Claude\\mcp-servers\\canada-travel-advisory\\index.js".

Werkzeuge

Alle Werkzeuge akzeptieren language (Standard "en" oder "fr"), wodurch Namen, Hinweistext und der Reiseziel-Link zwischen travel.gc.ca und voyage.gc.ca umgeschaltet werden.

Risikostufen

min_risk_level: 2 gibt alle Reiseziele aus, vor denen Kanada vom Reisen abrät. Filter akzeptieren auch den Bezeichnungstext (z.B. risk_level: "avoid all travel").

Beispielfragen, die dies beantwortet

• "Wie lautet der Reisehinweis für Peru?"

• "In welche Länder sollte ich derzeit alle Reisen vermeiden?"

• "Welche Hinweise haben sich in der letzten Woche geändert?"

• "Vergleichen Sie Japan, Mali und Frankreich für eine Reise."

• "Wie viele Reiseziele haben regionale Hinweise?"

Datenquelle und Verhaltenshinweise

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

• Es wird nur ein Endpunkt abgerufen, nicht zwei. Die veröffentlichte index-updated.json ist byte-identisch mit index-alpha-eng.json (überprüft: gleiche MD5, gleiche alphabetische Schlüsselreihenfolge) und ist nicht tatsächlich nach Aktualität sortiert. get_recent_updates sortiert daher lokal nach date-published.timestamp, was zuverlässig ist, unabhängig von der Reihenfolge der upstream-Datei.

• Ein Abruf bedient beide Sprachen. Trotz des Suffixes -eng enthält jeder Datensatz sowohl eng- als auch fra-Blöcke; die -fra-Datei unterscheidet sich nur in der Schlüsselreihenfolge.

• Caching: Antworten werden 60 Minuten lang im Arbeitsspeicher zwischengespeichert (der Datensatz wird etwa stündlich neu generiert) und mit bedingten If-None-Match-/If-Modified-Since-Anfragen aktualisiert. Wenn eine Aktualisierung fehlschlägt, werden die letzten gültigen Daten mit stale: true ausgeliefert, anstatt einen Fehler zu melden.

• Nur zusammenfassende Daten. Der Datensatz enthält Risikostufe, Hinweistext, Aktualisierungsdatum und Änderungszusammenfassung. Vollständige Hinweisdetails (Sicherheit, Einreisebestimmungen, Gesundheit, regionale Aufschlüsselungen) existieren nur als HTML, daher enthält jedes Ergebnis die url des Reiseziels, um sie zu lesen.

Jede Antwort enthält auch data_generated (upstream-Generierungszeit) und eine Quellenangabe, sodass Antworten datiert werden können.

Lizenz

MIT. Hinweisdaten © Government of Canada, verwendet unter der Open Government Licence – Canada.