easyonward

EasyOnward MCP サーバー

読み取り専用の Model Context Protocol サーバーです。MCP 対応の AI アシスタント（Claude Desktop、Cursor、ChatGPT desktop など）を使って、ある国から別の国へ渡航する際のパスポート、ビザ、入国、トランジットの要件を、政府の公式情報源と EasyOnward の詳細な分析へのディープリンク付きで確認できます。

EasyOnward が公開している、認証不要のビザペアエンドポイントを利用します。読み取り専用で、個人情報を送信せず、API キーも不要です。

法律上の助言や入国管理に関する助言ではありません。 結果は、パスポートの発行国のすべての国民を対象にした一般的な分析です。渡航前に、必ず航空会社および渡航先の当局に確認してください。

ツール

check_visa

指定したパスポートを所持する渡航者にビザが必要かどうか、また渡航先の入国要件とトランジット要件を、政府の公式情報源とともに確認します。

入力

フィールド	説明
passport_country	渡航者のパスポート発行国。ISO 3166-1 alpha-2 コード（US）または国名（United States）。
destination_country	渡航先の国。ISO 3166-1 alpha-2 コード（KE）または国名（Kenya）。

出力 — 読みやすいテキストと、以下を含む構造化オブジェクトの両方です。

• verdict — 平易な言葉による1行の要約（制限あり／条件付き／特に問題なし）。
• worst_severity — BLOCK | WARN | INFO | NONE。
• requirements[] — 該当する要件。各項目は severity、title、detail。
• official_sources[] — 重複を除いた、政府の公式情報源の URL。
• deep_link — 詳細な分析へのリンク https://easyonward.com/visa/{ORIGIN}-{DEST}。
• prepare_link — 同じページに ?ref=mcp を付加したリンク。ビザサービス、旅行保険、eSIM の各オプションと、公式の無料手段を比較できます。
• disclaimer。

country_code

国名（または既存の ISO-2 コード）を、大文字の ISO 3166-1 alpha-2 コードに変換するヘルパーです。例：Kenya → KE。check_visa の呼び出し前に便利です。

例

{ "passport_country": "US", "destination_country": "KE" } を指定して check_visa を呼び出す場合：

Travel from United States to Kenya is conditional — see requirements.

Requirements:
  [INFO] US travel advisory: Kenya — Level 2 (Exercise Increased Caution) — …
  [INFO] Be ready to show proof of funds for Kenya (KE) — …
  [WARN] An electronic travel authorization (eta) for Kenya on your United States (US) passport — …

Official government sources:
  - https://www.etakenya.go.ke
  - https://immigration.go.ke
  - https://travel.state.gov/…/kenya-travel-advisory.html
  …

Full details: https://easyonward.com/visa/US-KE

Generic analysis for any United States citizen. Not legal or immigration advice — verify with
your airline and the destination's authorities before travel.

インストールと実行

接続方法は2つあります。利用できるツールはどちらも同じです。

• ホステッド（リモート） — インストールも実行も不要です。HTTP 対応の MCP クライアントから https://mcp.easyonward.com/mcp（Streamable HTTP）に接続します。ほとんどのユーザーにおすすめです。
• ローカル（stdio） — npx を使って Node 18 以降で実行します（インストール不要）。

  npx -y @easyonward/mcp-server
  

  サーバーは stdio 経由で MCP を使用します。オフライン環境やエアギャップ環境、またはリモートトランスポートに対応していないクライアントにおすすめです。

ホステッド（リモート）— Claude Code／HTTP クライアント全般

claude mcp add --transport http easyonward https://mcp.easyonward.com/mcp

リモートサーバーに対応したクライアント設定に追加することもできます。

{
  "mcpServers": {
    "easyonward": {
      "type": "streamable-http",
      "url": "https://mcp.easyonward.com/mcp"
    }
  }
}

ホステッドサーバーは読み取り専用かつステートレスで、個人情報を扱いません。ローカル版と同じ2つのツールを提供します。

Claude Desktop（ローカル stdio）

claude_desktop_config.json に追加します （macOS：~/Library/Application Support/Claude/claude_desktop_config.json、 Windows：%APPDATA%\Claude\claude_desktop_config.json）。

{
  "mcpServers": {
    "easyonward": {
      "command": "npx",
      "args": ["-y", "@easyonward/mcp-server"]
    }
  }
}

Claude Desktop を再起動してから、次のように尋ねます。「米国からケニアへ飛ぶのにビザは必要ですか？」

Cursor

~/.cursor/mcp.json に追加します（または Settings → MCP → Add new server を選択します）。

{
  "mcpServers": {
    "easyonward": {
      "command": "npx",
      "args": ["-y", "@easyonward/mcp-server"]
    }
  }
}

Smithery

このサーバーには smithery.yaml マニフェストが含まれているため、Smithery レジストリからインストールできます。

npx -y @smithery/cli install @easyonward/mcp-server --client claude

Windsurf、Cline、その他の stdio クライアント

ローカル stdio MCP サーバーに対応したクライアントであれば、同じ設定ブロックを使用できます。 command: npx、args: ["-y", "@easyonward/mcp-server"] を指定します。Windsurf では Settings → Cascade → MCP Servers、Cline では MCP 設定 JSON を使用します。クライアント固有の設定は不要です。

設定

環境変数	デフォルト	用途
EASYONWARD_API_BASE	https://easyonward.com/api/v1	API のベース URL です。テストには開発／ステージング環境のホストを指定します。

例（開発環境のホストを指定）：

{
  "mcpServers": {
    "easyonward": {
      "command": "npx",
      "args": ["-y", "@easyonward/mcp-server"],
      "env": { "EASYONWARD_API_BASE": "https://dev.easyonward.com/api/v1" }
    }
  }
}

セキュリティとプライバシー

• 読み取り専用です。 サーバーは公開されている EasyOnward API に対して GET リクエストで検索を行うだけで、書き込み、予約、データの変更は一切行いません。
• シークレットも認証も不要です。 設定する API キーやトークンはないため、漏えいするものもありません。
• 個人を特定できる情報は扱いません。 送信するのはパスポートの発行国と渡航先の国のみです（ISO-2 コードまたは国名）。パスポート番号、氏名、生年月日などの個人データを尋ねたり送信したりすることはありません。
• 公開データのみを扱います。 返される情報はすべて、ビザ／入国／乗り継ぎに関する公開の参考情報で、政府の公式情報源へのリンクが含まれます。
• 安全に失敗します。 API に接続できない場合や、国の組み合わせがカタログにない場合は、クラッシュせず明確なメッセージを返します。リクエストには公開 API のレート制限が適用されます。

開発

npm install      # install deps
npm run build    # tsc -> dist/
npm test         # unit tests (mocked fetch)
npm start        # run the built server on stdio

このパッケージは専用のディレクトリに配置されており、EasyOnward のフロントエンド／バックエンドのツールや CI から意図的に分離されています。

ライセンス

MIT