simsima-connectivity — MCP-сервер

Веб-сайт: simsima.io · Эндпоинт: POST https://mcp.simsima.io/mcp (Streamable HTTP) · Реестр: io.github.Willyfab/simsima-connectivity

Публичный MCP-сервер, открывающий каталог travel eSIM от Simsima для AI-агентов. Эндпоинт: POST https://mcp.simsima.io/mcp (Streamable HTTP). Health: GET /health.

Инструменты

• list_destinations — страны/регионы покрытия, с минимальной ценой + URL продукта.

• search_plans — тарифы для направления, с опциональными фильтрами по цене/трафику/сроку действия.

• get_plan — один тариф по sku.

• recommend_plan — лучший(ие) тариф(ы) для поездки (длительность + лёгкое/среднее/интенсивное использование).

• create_checkout_link — URL продукта Simsima с атрибуцией агента (source/utm_*), тариф уже предвыбран.

• check_coverage — покрывает ли это направление данную страну? Принимает название страны или ISO-код и возвращает отдельный тариф для страны независимо от того, да или нет.

• get_destination_info — покрытие, мобильные операторы, доступность пополнения и входная цена для одного направления.

Только чтение + атрибутированные ссылки. Никаких платежей, данных о заказах, авторизации.

Related MCP server: a2a-travel-mcp-servers

Источник данных

Читает публичный веб-фид ${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 (опционально) — API-ключ проекта PostHog. Если задан, сервер отправляет событие mcp_tool_call на каждый вызов инструмента, несущее resultCount, feedStale и именованный failureReason, когда вызов возвращается пустым, плюс отдельное событие mcp_checkout_link, когда выдаётся ссылка на оформление заказа. Если отсутствует → телеметрия отключена (no-op).

• POSTHOG_HOST (опционально, по умолчанию https://eu.i.posthog.com) — хост приёма PostHog (должен совпадать с веб-приложением).

Локальная разработка

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, затем попробуйте: "Рекомендуй мне eSIM на 7 дней в Японии при среднем использовании."

Развёртывание

Приложение Coolify, контекст сборки Docker = mcp/, поддомен mcp.simsima.io. Авто-деплой при пуше в main. Задайте переменные окружения SIMSIMA_FEED_BASE, PORT, RATE_LIMIT_RPM.

Публикация в MCP Registry (Фаза 1b)

Метаданные находятся в server.json (namespace io.github.Willyfab/simsima-connectivity, remote streamable-http на https://mcp.simsima.io/mcp). Обнаружение также подсказывается из web/public/llms.txt + llms-full.txt.

Чтобы опубликовать (нужен CLI mcp-publisher + 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

• Увеличивайте version в server.json при каждом значимом изменении и повторно запускайте publish.

• Чтобы использовать брендированный namespace com.simsima/connectivity вместо этого, подтвердите владение доменом simsima.io через DNS TXT-запись, затем обновите name в server.json (remote URL mcp.simsima.io уже находится на подтверждённом домене).