simsima-connectivity — MCP 服务器

网站： simsima.io · 端点： POST https://mcp.simsima.io/mcp（Streamable HTTP） · 注册表： io.github.Willyfab/simsima-connectivity

公开的 MCP 服务器，将 Simsima 的旅行 eSIM 目录开放给 AI 代理。 端点：POST https://mcp.simsima.io/mcp（Streamable HTTP）。健康检查：GET /health。

工具

• list_destinations — 覆盖的国家/地区，含最低价格 + 产品 URL。

• search_plans — 某个目的地的套餐，可选用价格/流量/有效期筛选。

• get_plan — 按 sku 获取单个套餐。

• recommend_plan — 为行程推荐最佳套餐（时长 + 轻度/中度/重度使用）。

• create_checkout_link — 带代理归因（source/utm_*）的 Simsima 产品 URL，套餐已预先选定。

• check_coverage — 该目的地是否覆盖此国家？接受国家名称或 ISO 代码，无论答案是肯定还是否定，都会返回对应的单国套餐。

• get_destination_info — 单个目的地的覆盖范围、移动运营商、充值可用性和入门价格。

仅读取 + 带归因的链接。无支付、无订单数据、无认证。

Related MCP server: a2a-travel-mcp-servers

数据源

读取公共 Web 源 ${SIMSIMA_FEED_BASE}/{locale}/agent/catalog（缓存约 15 分钟）。 产品 URL 直接来自该源 → 始终有效（零 404）。无数据库，无后端调用。

该源由 Simsima 的可销售目录构建——与网站和 Google Shopping 源读取的是同一来源。因此，此服务器回答的内容就是网站实际销售的内容：每个 （目的地、流量、时长）一个套餐，无限流量套餐通过站点的公平使用级联解析，并且 结账价格下限已应用。

覆盖范围和移动运营商位于源的 destinations 块中，每个目的地出现一次， 而不是在每个套餐上（仅欧洲区域就携带约 40 个国家代码）。运营商仅针对 单国目的地列出：在区域上，四十个国家的网络混在一起不会提供任何有用信息。

环境变量

• SIMSIMA_FEED_BASE（默认 https://simsima.io）

• PORT（默认 8080）

• RATE_LIMIT_RPM（默认 60）

• POSTHOG_KEY（可选）— PostHog 项目 API 密钥。设置后，服务器会在每次工具调用时发出 mcp_tool_call 事件，携带 resultCount、feedStale，并在调用返回空时携带具名的 failureReason；此外，在发放结账链接时会发出专门的 mcp_checkout_link 事件。未设置 → 遥测禁用（无操作）。

• POSTHOG_HOST（可选，默认 https://eu.i.posthog.com）— PostHog 摄取主机（与 Web 应用匹配）。

本地开发

cd mcp
npm install
npm test          # jest (42 tests)
npm run dev       # ts-node-dev on :8080
curl localhost:8080/health

从 Claude 连接（私有验证 — 阶段 1a）

添加一个指向 https://mcp.simsima.io/mcp 的自定义连接器，然后尝试： "Recommande-moi un eSIM pour 7 jours au Japon en usage moyen."

部署

Coolify 应用，Docker 构建上下文 = mcp/，子域 mcp.simsima.io。推送到 main 时自动部署。 设置 SIMSIMA_FEED_BASE、PORT、RATE_LIMIT_RPM 环境变量。

发布到 MCP 注册表（阶段 1b）

元数据位于 server.json（命名空间 io.github.Willyfab/simsima-connectivity， 远程 streamable-http 位于 https://mcp.simsima.io/mcp）。发现也通过 web/public/llms.txt + llms-full.txt 提示。

要发布（需要 mcp-publisher CLI + 以仓库所有者身份进行 GitHub 认证）：

cd mcp
# install: see github.com/modelcontextprotocol/registry (release binary or `go install`)
mcp-publisher login github     # OIDC auth for the io.github.Willyfab/* namespace
mcp-publisher publish          # validates server.json and publishes

• 每次有意义的更改时，在 server.json 中提升 version 并重新运行 publish。

• 要使用品牌化的 com.simsima/connectivity 命名空间，请通过 DNS TXT 记录验证 simsima.io 的域名所有权，然后更新 server.json 中的 name （远程 URL mcp.simsima.io 已位于已验证的域名上）。