Skip to main content
Glama
Canada Travel Advisory MCP Server

Canada Travel Advisory MCP Server

by w-metcalfe

Canada Travel Advisory MCP Server

MCP-сервер для рекомендаций по поездкам правительства Канады, работающий на основе открытого индекса данных Global Affairs Canada, содержащего 230 направлений.

Лёгкий по дизайну: один index.js, одна зависимость (@modelcontextprotocol/sdk), без этапа сборки, без компиляции TypeScript, без HTTP-библиотеки.

Установка

npm install

Требуется Node.js 18+ (используется встроенный fetch).

Related MCP server: EasyOnward MCP Server

Настройка

API-ключ не нужен — набор данных общедоступный и не требует аутентификации. Все клиенты ниже запускают одну и ту же stdio-команду: node <path-to>/index.js.

Подставьте собственный абсолютный путь, если проект расположен в другом месте.

Claude Code

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

Добавьте --scope user, чтобы сделать его доступным во всех ваших проектах, а не только в текущем.

Claude Desktop

В claude_desktop_config.json (Settings → Developer → Edit Config):

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

Перезапустите Claude Desktop после сохранения.

Codex CLI

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

Или отредактируйте ~/.codex/config.toml напрямую (используйте .codex/config.toml в корне проекта, чтобы ограничить его одним доверенным проектом):

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

Проверьте с помощью codex mcp list.

Cursor

Создайте .cursor/mcp.json в корне проекта или ~/.cursor/mcp.json, чтобы включить его глобально:

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

Затем сервер появится в Settings → MCP, где его необходимо включить.

Примечание о путях Windows

Указанные выше прямые слэши отлично работают в Windows. Если вы предпочитаете обратные слэши в JSON-конфигах, экранируйте их: "E:\\Claude\\mcp-servers\\canada-travel-advisory\\index.js".

Инструменты

Инструмент

Назначение

get_travel_advisory

Рекомендации для одного направления. Принимает название (англ. или фр.), код ISO (JP) или слаг (costa-rica). Неоднозначный ввод возвращает кандидатов.

list_travel_advisories

Фильтрация и просмотр всех направлений по risk_level, min_risk_level, has_regional_advisory; сортировка по name / risk / updated; постраничный вывод через limit + offset.

get_recent_updates

Рекомендации, изменённые недавно, сначала новые. Фильтрация по days и update_type.

search_countries

Частичный поиск по названиям, кодам ISO и слагам.

compare_advisories

Сравнение нескольких направлений сразу, с сортировкой по убыванию риска.

get_advisory_statistics

Обзор набора данных: количество по уровням риска, количество региональных рекомендаций, разбивка по типам изменений, актуальность.

Все инструменты принимают language ("en" по умолчанию или "fr"), который переключает названия, текст рекомендаций и ссылку на направление между travel.gc.ca и voyage.gc.ca.

Уровни риска

Уровень

Значение

0

Соблюдайте обычные меры предосторожности

1

Проявляйте повышенную осторожность

2

Избегайте необязательных поездок

3

Избегайте любых поездок

min_risk_level: 2 возвращает все направления, в которые Канада рекомендует не ездить. Фильтры также принимают текст метки (например, risk_level: "avoid all travel").

Примеры вопросов, на которые это отвечает

  • «Каковы рекомендации по поездкам для Перу?»

  • «В какие страны сейчас следует избегать любых поездок?»

  • «Какие рекомендации изменились за последнюю неделю?»

  • «Сравните Японию, Мали и Францию для поездки.»

  • «Сколько направлений имеют региональные рекомендации?»

Источник данных и примечания о поведении

Источник: https://data.international.gc.ca/travel-voyage/index-alpha-eng.json

  • Запрашивается только одна конечная точка, а не две. Опубликованный index-updated.json побайтно идентичен index-alpha-eng.json (проверено: одинаковый MD5, одинаковый алфавитный порядок ключей) и на самом деле не отсортирован по новизне. Поэтому get_recent_updates сортирует по date-published.timestamp локально, что надёжно независимо от порядка записей в исходном файле.

  • Один запрос обслуживает оба языка. Несмотря на суффикс -eng, каждая запись содержит оба блока eng и fra; файл -fra отличается только порядком ключей.

  • Кэширование: ответы кэшируются в памяти на 60 минут (набор данных перегенерируется примерно ежечасно) и обновляются с помощью условных запросов If-None-Match / If-Modified-Since. Если обновление не удаётся, отдаются последние корректные данные с stale: true вместо ошибки.

  • Только сводные данные. Набор содержит уровень риска, текст рекомендации, дату обновления и сводку изменений. Полные детали рекомендации (безопасность, требования въезда, здоровье, региональные разбивки) существуют только в виде HTML, поэтому каждый результат включает url назначения для их просмотра.

Каждый ответ также содержит data_generated (время генерации в источнике) и строку с указанием источника, что позволяет датировать ответы.

Лицензия

MIT. Данные рекомендаций © Government of Canada, используются по лицензии Open Government Licence – Canada.

Available Tools

6 tools
compare_advisoriesB

Compare travel advisories for several destinations at once, ranked from highest to lowest risk. Useful for planning a multi-country trip.

Inputs: countries (required), language.

get_advisory_statisticsA

Overview of the whole advisory dataset: how many destinations sit at each risk level, how many carry regional advisories, a breakdown of recent change types, and when the data was generated.

Inputs: language.

get_recent_updatesA

Get advisories updated most recently, newest first. Use this for 'what changed this week' questions. Optionally restrict to a change type such as 'Regional advisory added' or 'National advisory decreased'.

Inputs: days, limit, language, update_type.

get_travel_advisoryA

Get the current Government of Canada travel advisory for a single country. Accepts a country name (English or French), an ISO code, or a URL slug. Returns the risk level, advisory text, when it was last updated, what changed, and a link to the full advisory page.

Inputs: country (required), language.

list_travel_advisoriesA

List and filter travel advisories across all 230 destinations. Use min_risk_level: 2 to find everywhere Canada advises against travel. Sort by name, risk, or most recently updated.

Inputs: sort, limit, offset, language, +3 more.

search_countriesA

Search destinations by partial name, ISO code, or slug. Use this to discover or disambiguate a destination before calling get_travel_advisory.

Inputs: query (required), limit, language.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a distinct purpose: single-country lookup, list/filter across all, recent changes, search/disambiguation, comparison, and statistics. No two tools overlap in function; an agent can clearly choose based on need.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (get_, list_, get_recent_, search_, compare_, get_). This predictability helps an agent understand the action and target without ambiguity.

    Tool Count5/5

    Six tools is ideal for the scope: covering single query, list, recent updates, search, comparison, and statistics. Each tool serves a distinct and necessary use case without redundancy or unnecessary bloat.

    Completeness5/5

    The tool surface covers all common travel advisory workflows: lookup, filtering, discovering recent changes, searching/disambiguation, multi-country comparison, and aggregate statistics. No obvious gaps—users can answer questions about specific countries, broad trends, or comparisons.

    Related MCP Connectors

    Related MCP Servers