캐나다 여행 권고 MCP 서버

캐나다 정부의 여행 권고를 위한 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에서 (설정 → 개발자 → 구성 편집):

{
  "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"]
    }
  }
}

그러면 서버가 설정 → 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. 권고 데이터 © 캐나다 정부, Open Government Licence – Canada에 따라 사용됨.