esim-mcp

esim-mcp

用于旅行 eSIM 套餐的 MCP 服务。 它可以让 Claude、Cursor 及任何其他 Model Context Protocol 客户端按国家/地区搜索旅行 eSIM 流量套餐、比较价格，并计算多国旅行时保持联网的最省钱方案。

询问“日本和韩国两周旅行，最便宜的 eSIM 是什么？”，即可获取真实套餐和真实价格，而不是猜测。

esim-mcp 由 CheapereSIM 构建并维护，返回 CheapereSIM 的价格。它覆盖 8 个区域、190 多个目的地。

你可以询问什么

安装后，以下问题都可以直接用自然语言询问：

• “日本最便宜的 eSIM 是什么？”
• “我要去日本、韩国和台湾旅行三周，应该买什么？”
• “有没有一张 eSIM 可以覆盖整个东南亚？”
• “那个区域套餐具体覆盖哪些国家/地区？”
• “给我看看土耳其的无限流量 eSIM 套餐。”
• “我的 eSIM 还剩多少流量？”（需要令牌）

多国旅行的情况尤其值得关注。覆盖整个行程的区域 eSIM 有时比在每个国家/地区分别购买本地 eSIM 更便宜，有时则不然。plan_trip 会分别计算两种方案的价格，并告诉你哪种更划算。

设置

将以下内容添加到 MCP 客户端配置中：

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

搜索目的地和比较套餐无需 API 密钥、账户或配置。只有在还想使用两个账户工具时，才需要设置 CHEAPERESIM_API_TOKEN。

示例：规划多国旅行

使用 plan_trip 规划日本、韩国和台湾的三周旅行，并要求至少 10GB 流量：

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.

这是根据实时价格生成的真实结果，不是示例。这个案例也值得深入了解：购买本地套餐的价格只有一半，但仍然不是正确答案，因为台湾只包含在区域套餐中。如果价格比较只看更低的数字，你会有三分之一的行程无法使用服务。

服务会按照 API 返回的原样打印每个 buy_url，因此上面的链接就是你会获得的链接。

工具

工具	描述	需要令牌
search_destinations	按完整名称或部分名称查找 CheapereSIM 销售 eSIM 套餐的国家/地区。	否
list_plans	列出某个国家/地区的 eSIM 套餐，按价格从低到高排序。	否
plan_trip	计算在多个国家/地区旅行时保持联网的最省钱方案。	否
get_plan_coverage	列出区域或全球套餐覆盖的所有国家/地区。	否
list_popular_destinations	列出旅行者最常购买 eSIM 的目的地。	否
list_my_esims	列出配置的 CheapereSIM 账户中的 eSIM。	是
get_esim_usage	显示某张 eSIM 还剩多少流量。	是

只有设置了 CHEAPERESIM_API_TOKEN，才会注册 list_my_esims 和 get_esim_usage。未设置令牌时，服务只会公开前五个工具，因此模型不会看到无法调用的工具。

环境变量

变量	默认值	用途
CHEAPERESIM_API_BASE	https://cheaperesim.com	CheapereSIM API 的基础 URL
CHEAPERESIM_API_TOKEN	未设置	两个账户工具的 API 令牌；省略此变量即可在只读查询模式下运行
CHEAPERESIM_TIMEOUT_MS	10000	请求超时时间，单位为毫秒

请确保 CHEAPERESIM_API_BASE 使用 https。令牌会通过 bearer 请求头发送，因此使用 http 覆盖此设置会导致令牌以明文形式通过网络传输。

获取令牌

在 cheaperesim.com/dashboard/api-tokens 创建令牌。令牌是只读的：可以列出你的 eSIM 及其用量，但无法购买套餐、更改个人资料或删除账户。请像保护密码一样保护令牌，如果令牌泄露，请撤销它。

常见问题

什么是 eSIM？ eSIM 是一种数字 SIM 卡，手机会将其下载到设备中，无需像使用塑料卡那样插拔。大约从 2018 年起销售的大多数手机都支持 eSIM，因此你可以在抵达前购买目的地的移动数据，免去漫游费用。

可以搜索哪些国家和地区？ 覆盖欧洲、亚洲、北美和南美、非洲、大洋洲及中东的 190 多个目的地，另外还有覆盖多个国家和地区的区域套餐和全球套餐。使用 search_destinations 查询特定目的地。

安装需要付费吗？ 不需要。服务和五个查询工具均免费使用，也无需账户。只有在 cheaperesim.com 上决定购买套餐时才需要付费。

购买区域 eSIM 比每个国家单独购买更便宜吗？ 这取决于行程，这正是 plan_trip 存在的原因。前往两个相邻国家时，通常购买两份当地套餐更划算；前往四五个国家时，区域套餐通常更划算。该工具会为两种方案定价并显示差额。

除了 Claude 之外也能使用吗？ 可以。它通过标准输入/输出使用 Model Context Protocol，因此任何 MCP 客户端都可以运行它，包括 Cursor 和基于 MCP SDK 构建的自定义 Agent。

它能替我购买套餐吗？ 不能，这是刻意设计的。所有工具都为只读。工具会返回套餐链接，购买操作需在浏览器中通过 cheaperesim.com 完成。

开发

npm install
npm test
npm run build

npm run typecheck 会对测试和源代码进行类型检查。CI 会在 Node 20 和 22 上运行构建、类型检查和测试套件。

许可证

MIT。请参阅 LICENSE。