esim-mcp

esim-mcp

旅行用 eSIM プラン向けの MCP サーバーです。 Claude、Cursor、その他あらゆる Model Context Protocol クライアントで、国ごとの旅行用 eSIM データプランを検索し、価格を比較して、複数の国を巡る旅行で接続を維持する最安の方法を調べられます。

「日本と韓国で2週間使う場合、最も安い eSIM は？」と尋ねると、推測ではなく、実際のプランと実際の価格が返ってきます。

esim-mcp は CheapereSIM が開発・保守しており、CheapereSIM の価格を返します。8つの地域にわたる190以上の渡航先をカバーしています。

質問できること

インストールすると、次のような質問を自然な言葉でできます。

• 「日本で最も安い eSIM はどれですか？」
• 「日本、韓国、台湾を3週間旅行します。何を買えばよいですか？」
• 「東南アジア全域をカバーする eSIM はありますか？」
• 「その地域プランは、実際にはどの国をカバーしていますか？」
• 「トルコの無制限データ eSIM プランを見せてください。」
• 「eSIM のデータ残量はいくらですか？」（トークンが必要です）

特に便利なのは、複数の国を巡るケースです。旅行全体をカバーする地域 eSIM のほうが各国のローカル eSIM を購入するより安い場合もあれば、そうでない場合もあります。plan_trip は両方の価格を調べ、どちらが有利かを教えてくれます。

セットアップ

MCP クライアントの設定に以下を追加してください。

{
  "mcpServers": {
    "esim": {
      "command": "npx",
      "args": ["-y", "esim-mcp"]
    }
  }
}

渡航先の検索やプランの比較には、API キーもアカウントも設定も必要ありません。アカウント関連の2つのツールも使う場合のみ、CHEAPERESIM_API_TOKEN を設定してください。

例：複数の国を巡る旅行の計画

日本、韓国、台湾を3週間旅行する場合について、最低10GBの条件で plan_trip に尋ねます。

Option 1 - one plan covering everything, $34.58:
Asia (12 areas) 10GB 30Days: 10 GB for 30 days - $34.58 - covers 12 countries
  https://cheaperesim.com/multi-country-esim?package=2488&utm_source=mcp&utm_medium=ai&utm_campaign=esim-mcp

Option 2 - one local plan per country, $17.52 total:
Japan 10GB 30Days: 10 GB for 30 days - $8.76
  https://cheaperesim.com/esim/japan?package=339&utm_source=mcp&utm_medium=ai&utm_campaign=esim-mcp
South Korea 10GB 30Days: 10 GB for 30 days - $8.76
  https://cheaperesim.com/esim/south-korea?package=345&utm_source=mcp&utm_medium=ai&utm_campaign=esim-mcp
No local plan available for: TW.

Recommended: option 1, since option 2 does not cover: TW.

これは例示ではなく、実際の価格情報を使った実際の出力です。また、理解しておく価値のあるケースでもあります。ローカル eSIM を購入するほうが半額ですが、それでも正解ではありません。台湾は地域プランでのみ販売されているためです。安いほうの金額だけで比較を終えると、旅行期間の3分の1はサービスを利用できなくなります。

サーバーは API が返したとおりに各 buy_url を出力するため、上記のリンクは実際に取得できるものです。

ツール

ツール	説明	トークンが必要
search_destinations	CheapereSIM が eSIM プランを販売している国を、正式名称または部分一致で検索します。	いいえ
list_plans	1か国の eSIM プランを、安い順に一覧表示します。	いいえ
plan_trip	複数の国を巡る旅行で接続を維持する最安の方法を調べます。	いいえ
get_plan_coverage	地域プランまたはグローバルプランがカバーするすべての国を一覧表示します。	いいえ
list_popular_destinations	旅行者が最もよく eSIM を購入する渡航先を一覧表示します。	いいえ
list_my_esims	設定済みの CheapereSIM アカウントにある eSIM を一覧表示します。	はい
get_esim_usage	1つの eSIM のデータ残量を表示します。	はい

list_my_esims と get_esim_usage は、CHEAPERESIM_API_TOKEN が設定されている場合のみ登録されます。トークンがない場合、サーバーが公開するのは最初の5つのツールだけなので、モデルに呼び出せないツールが表示されることはありません。

環境変数

変数	デフォルト	用途
CHEAPERESIM_API_BASE	https://cheaperesim.com	CheapereSIM API のベース URL
CHEAPERESIM_API_TOKEN	未設定	2つのアカウント関連ツール用の API トークン。読み取り専用の検索モードで実行する場合は省略してください
CHEAPERESIM_TIMEOUT_MS	10000	リクエストのタイムアウト時間（ミリ秒）

CHEAPERESIM_API_BASE は https のままにしてください。トークンはベアラーヘッダーとして送信されるため、http に上書きすると、トークンが平文でネットワーク上に送信されます。

トークンの取得

cheaperesim.com/dashboard/api-tokens でトークンを作成してください。トークンは読み取り専用です。eSIMとその使用状況を一覧表示できますが、プランの購入、プロフィールの変更、アカウントの削除はできません。パスワードと同じように扱い、漏えいした場合は無効化してください。

FAQ

eSIMとは何ですか？ プラスチックカードを差し替える代わりに、スマートフォンにダウンロードして使うデジタルSIMです。2018年ごろ以降に販売されたスマートフォンの多くが対応しているため、到着前に渡航先のモバイルデータを購入して、ローミング料金を回避できます。

どの国を検索できますか？ ヨーロッパ、アジア、北米、南米、アフリカ、オセアニア、中東の190以上の渡航先に加え、一度に複数の国をカバーする地域別プランやグローバルプランも検索できます。特定の渡航先を確認するには、search_destinations を使用してください。

インストールに費用はかかりますか？ いいえ。サーバーと5つの検索ツールは無料で、アカウントも必要ありません。料金が発生するのは、cheaperesim.comでプランを購入する場合のみです。

国ごとに購入するより、地域別eSIMのほうがお得ですか？ 旅行先によって異なります。それを確認するために plan_trip があります。隣接する2か国への旅行なら、現地プランを2つ購入するほうがお得な場合が多く、4〜5か国にまたがる旅行なら、通常は地域別プランがお得です。このツールは両方の料金を比較し、差額を表示します。

Claude以外でも使えますか？ はい。stdio経由でModel Context Protocolを使用するため、CursorやMCP SDKで構築されたカスタムエージェントなど、あらゆるMCPクライアントで実行できます。

代わりにプランを購入してもらえますか？ いいえ。これは仕様です。すべてのツールは読み取り専用です。プランの情報にはリンクが含まれており、購入はブラウザーでcheaperesim.comにアクセスして行います。

開発

npm install
npm test
npm run build

npm run typecheck は、ソースと同様にテストも型チェックします。CIではNode 20および22で、ビルド、型チェック、テストスイートを実行します。

ライセンス

MITです。LICENSEを参照してください。