simsima-connectivity — MCP 서버

웹사이트: simsima.io · 엔드포인트: POST https://mcp.simsima.io/mcp (Streamable HTTP) · 레지스트리: io.github.Willyfab/simsima-connectivity

Simsima의 여행용 eSIM 카탈로그를 AI 에이전트에 제공하는 공개 MCP 서버입니다. 엔드포인트: 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: gliana-mcp-remote

데이터 소스

공개 웹 피드 ${SIMSIMA_FEED_BASE}/{locale}/agent/catalog를 읽습니다(약 15분 캐시). 제품 URL은 피드에서 직접 가져오므로 항상 유효합니다(404 없음). 데이터베이스 없음, 백엔드 호출 없음.

이 피드는 Simsima의 판매 가능 카탈로그에서 생성됩니다. 웹사이트와 Google Shopping 피드가 읽는 것과 동일한 소스입니다. 따라서 이 서버가 응답하는 내용은 사이트에서 실제로 판매하는 내용입니다: (목적지, 데이터, 기간)별 하나의 플랜, 사이트의 fair-use 캐스케이드를 통해 결정되는 무제한 플랜, 그리고 체크아웃 최저 가격이 이미 적용되어 있습니다.

커버리지와 이동통신사 정보는 피드의 destinations 블록에 목적지당 한 번씩 포함되며, 플랜마다 반복되지는 않습니다(유럽 존만 해도 약 40개의 국가 코드가 포함됩니다). 이동통신사는 단일 국가 목적지에 대해서만 나열됩니다. 존의 경우 40개 국가의 네트워크가 뒤섞여 있으면 유용한 정보를 제공하지 못합니다.

환경 변수

• SIMSIMA_FEED_BASE (기본값 https://simsima.io)

• PORT (기본값 8080)

• RATE_LIMIT_RPM (기본값 60)

• POSTHOG_KEY (선택 사항) — PostHog 프로젝트 API 키. 설정된 경우 서버는 도구 호출마다 resultCount와 feedStale을 포함하는 mcp_tool_call 이벤트를 내보내며, 호출 결과가 비어 있으면 이름이 지정된 failureReason도 포함합니다. 또한 체크아웃 링크가 전달되면 전용 mcp_checkout_link 이벤트를 내보냅니다. 설정하지 않으면 원격 분석(telemetry)이 비활성화됩니다(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를 가리키는 사용자 지정 커넥터를 추가한 다음 다음을 시도하세요: "일본에서 7일간 보통 사용량으로 사용할 eSIM을 추천해 줘."

배포

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을 업데이트하세요 (mcp.simsima.io 원격 URL은 이미 검증된 도메인에 있습니다).