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: Travel Assistant MCP

Настройка

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".

Инструменты

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

Уровни риска

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.