SMS8 - SMS GATEWAY using your phone

SMS8 MCP 서버

SMS 게이트웨이 → sms8.io  ·  바이브 코더 및 개발자를 위한 SMS 게이트웨이 MCP → mcp.sms8.io

Claude Code, Cursor, Windsurf, OpenCode 및 모델 컨텍스트 프로토콜을 지원하는 모든 AI 코딩 도구에서 SMS 전송, OTP 발급 및 검증, 수신 코드 대기, 웹훅 설정을 할 수 있습니다. SMS는 SMS8 플랫폼을 통해 페어링된 Android 휴대폰으로 라우팅됩니다.

라이브 서버: https://mcp.sms8.io 대시보드: https://app.sms8.io 마케팅 사이트: https://sms8.io

사용 이유

앱을 개발 중이며 SMS 알림, OTP, 양방향 메시징 또는 자율 에이전트 전화 인증이 필요하신가요? 대부분의 옵션은 통신사 프로그램 등록, 전화번호 프로비저닝, 메시지당 요금 지불 또는 세션당 일회용 SIM 대여를 요구합니다. SMS8은 이미 소유한 휴대폰을 통해 SMS를 라우팅합니다. MCP 서버는 AI 어시스턴트가 직접 호출할 수 있는 9가지 도구를 제공하므로, SMS를 프로젝트에 추가하는 데 한 시간의 통합 작업 대신 프롬프트 하나면 충분합니다.

제공 기능

도구	목적
setup_sms8	API 키 검증, 계정 컨텍스트 및 코드 샘플 반환
send_sms	페어링된 Android 기기를 통해 SMS 하나 전송
send_otp	인증 코드 생성 및 전송
verify_otp	입력된 코드를 최신 발급 OTP와 비교
wait_for_otp	신규. 페어링된 Android에서 OTP가 도착할 때까지 차단 후 코드 추출
get_messages	최근 수신함 또는 발신 SMS 반환
list_devices	페어링된 Android 기기 목록 표시
get_balance	신규. 간편한 크레딧 및 갱신 확인
create_webhook	수신 SMS 및 전송 이벤트에 대한 콜백 URL 등록

모든 도구는 SMS8 대시보드와 동일한 전송 파이프라인을 공유합니다. 크레딧, 재시도, 다중 기기 라우팅 및 웹훅 서명은 직접 API 호출과 동일하게 작동합니다.

SMS8 vs Twilio vs MessageBird

기능	SMS8	Twilio	MessageBird
내장 MCP 서버	예	아니요	아니요
메시지당 요금	없음	$0.0079+	$0.05+
A2P 10DLC 필요	아니요	예	예
전화번호 프로비저닝	불필요	월 $1+	월 $2+
설정 시간	60초	수일~수주	수일
OTP 인증 내장	예	추가 서비스	추가 서비스
오픈소스 MCP 코드	MIT	아니요	아니요

npm을 통한 설치

6개의 패키지가 모든 흐름을 지원하므로 프로젝트에 맞는 것을 선택하세요.

패키지	실행 명령	사용 사례
sms8-mcp	npx -y sms8-mcp	Claude Code, Cursor, Windsurf, OpenCode용 MCP 런처
sms8-cli	npx sms8-cli send +1234 "hi"	전송 / OTP / 수신함 / 기기용 터미널 CLI
react-sms-otp	npm i react-sms-otp	React useSms8Otp() + <OtpForm /> + <OtpInput /> (구분자, RTL, 마스크, 렌더 프롭)
sms-otp-verify	npm i sms-otp-verify	동일 코드, "sms otp verify" / "otp input" 검색용 SEO 타겟 이름
capacitor-sms-otp-send-verify	npm i capacitor-sms-otp-send-verify	Ionic 앱용 Capacitor 플러그인 — 네이티브 iOS Swift + Android Kotlin + 웹 폴백
cordova-plugin-sms-otp-send	cordova plugin add cordova-plugin-sms-otp-send	Ionic 앱용 Cordova 플러그인 — 네이티브 iOS Swift + Android Kotlin
sms-otp-using-myphone	npx sms-otp-using-myphone send +1234	동일 CLI의 OTP 전용 브랜드
phone-sms-gateway	npx phone-sms-gateway send +1234 "hi"	동일 CLI의 휴대폰 게이트웨이 브랜드
send-sms-from-android	npx send-sms-from-android send +1234 "hi"	동일 CLI의 Android 우선 브랜드

MCP 예제 (Claude Code, Cursor, Windsurf — 동일한 구성 형태):

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "sms8-mcp"],
      "env": { "SMS8_API_KEY": "sk_xxx" }
    }
  }
}

CLI 예제:

export SMS8_API_KEY=sk_xxx
npx sms8-cli send +14155550100 "Hello"
CODE=$(npx sms8-cli otp wait +Google --timeout=120)

React 예제:

import { OtpForm } from 'react-sms-otp';

<OtpForm
  apiKey={process.env.NEXT_PUBLIC_SMS8_API_KEY!}
  onVerified={(phone) => router.push('/dashboard')}
/>

6개 패키지의 소스는 모두 npm-packages/에 있습니다.

iOS + Android SDK

네이티브 모바일 앱의 경우, sdks/ 폴더에 Kotlin(Android) 및 Swift(iOS) SDK가 전송 / 인증 API + SMS 자동 완성 도우미(Android의 Google SMS Retriever, iOS의 oneTimeCode 콘텐츠 유형)와 함께 제공됩니다.

SDK	설치	자동 완성
sms8-swift	Swift Package Manager — README 참조	iOS OTPTextField SwiftUI 뷰
sms8-android	JitPack — README 참조	SMSRetriever.start(activity) — SMS 권한 불필요

두 SDK 모두 MIT 라이선스이며, 동일한 SMS8 API 키를 공유하고 동일한 Twilio Verify 대체 사용 사례를 대상으로 합니다.

빠른 시작

1. SMS8 계정 생성

app.sms8.io에서 가입하세요. 신용카드 없이 5일 무료 평가판을 제공합니다. QR을 통해 Android 휴대폰을 페어링하고 프로필 > API에서 API 키를 복사하세요.

2. 도구에 MCP 서버 추가

호스팅 HTTP (Claude Code, Cursor, Windsurf, Codex, Devin)

{
  "mcpServers": {
    "sms8": {
      "url": "https://mcp.sms8.io",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_SMS8_API_KEY"
      }
    }
  }
}

Claude Code 플러그인 (단일 명령)

/plugin marketplace add 1fancy/sms8-sms-gateway
/plugin install sms8-sms-gateway

그런 다음 Claude Code를 실행하기 전에 셸에서 export SMS8_API_KEY=sk_xxx을 실행하세요.

stdio 클라이언트용 npx

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "@sms8/mcp"],
      "env": { "SMS8_API_KEY": "sk_your_key" }
    }
  }
}

3. 설정 마법사

app.sms8.io/mcp-setup.php의 대시보드는 각 AI 도구에 대한 JSON을 미리 채워주고, 필요한 경우 기기 페어링 QR을 표시하며, 실시간 SMS 테스트 양식을 포함합니다.

4. AI에게 요청

Add SMS verification to my signup flow using the sms8 MCP.

AI가 setup_sms8을 호출한 다음 send_otp 및 verify_otp을 호출하고, 처음 시도부터 작동하는 프로덕션 코드를 작성합니다.

사용 사례

Claude Code, Cursor 또는 Windsurf에 붙여넣을 수 있는 실제 한 줄 프롬프트입니다.

회원가입 시 전화 인증

Wire phone-number verification into this app using the sms8 MCP. Use
send_otp on /signup, verify_otp on /verify-phone. Render the remaining
attempts on error.

주문 배송 알림

When an order ships, send the customer an SMS with their tracking link
via the sms8 MCP.

양방향 지원 수신함

Register a webhook with the sms8 MCP at https://my-app.com/sms-inbox.
Scaffold the handler that verifies the HMAC signature and routes inbound
SMS to the support queue.

SMS를 통한 비밀번호 없는 로그인

Replace the magic-link email login with SMS OTPs using the sms8 MCP.
6-digit code, 5-minute expiry, 5 attempts.

관리자 페이지용 SMS 2FA

Add SMS 2FA to /admin login via the sms8 MCP. Lock the account after
5 failed verify_otp attempts.

바로 사용 가능한 코드 예제

examples/의 각 파일은 프로덕션 준비가 완료되었으며, 의존성이 없고 복사하여 붙여넣을 수 있습니다. 이는 AI가 setup_sms8 핸드셰이크 후 생성하는 코드입니다.

• php-send.php: send, sendOtp, verifyOtp을 포함한 최소 Sms8Sender 클래스
• js-fetch.js: Node / 브라우저 / Cloudflare Worker 클라이언트 (ESM 및 CommonJS)
• otp-flow.php: 완전한 전화 인증 흐름 (startSignup + verifySignup)
• webhook-handler.php: HMAC 서명 확인이 포함된 수신 SMS 핸들러

자주 묻는 질문

SMS8 MCP 서버란 무엇인가요?

모델 컨텍스트 프로토콜을 구현하는 mcp.sms8.io의 HTTPS 엔드포인트입니다. AI 코딩 도구가 JSON-RPC 인터페이스를 호출하여 SMS 전송, OTP 발급 및 웹훅 설정을 수행합니다. SMS는 SMS8 플랫폼을 통해 페어링된 Android 휴대폰으로 라우팅됩니다.

Twilio와 어떻게 다른가요?

SMS8은 기존 SIM 카드가 있는 자신의 Android 휴대폰을 게이트웨이로 사용합니다. 메시지당 통신사 요금, A2P 10DLC 등록, 프로비저닝할 전화번호가 없습니다. 정액 요금제를 지불하고 무제한 SMS를 보낼 수 있습니다. MCP 서버는 AI 어시스턴트가 직접 호출할 수 있는 7가지 도구를 제공하며, 이는 Twilio가 제공하지 않는 기능입니다.

Claude Code와 작동하나요?

예. https://mcp.sms8.io를 가리키는 HTTP 전송과 Bearer 토큰으로 SMS8 API 키를 사용하여 ~/.config/claude/mcp-servers.json에 MCP 서버를 추가하세요. 또는 /plugin marketplace add 1fancy/sms8-sms-gateway을 실행한 다음 /plugin install sms8-sms-gateway를 실행하세요.

Cursor 및 Windsurf와 작동하나요?

예. 둘 다 HTTP MCP 서버를 지원합니다. ~/.cursor/mcp.json(Cursor) 또는 ~/.codeium/windsurf/mcp_config.json(Windsurf)에 API 키를 Bearer 헤더로 포함하여 https://mcp.sms8.io를 추가하세요. app.sms8.io/mcp-setup.php의 설정 마법사가 도구별로 JSON을 미리 채워줍니다.

AI가 OTP 인증을 자동으로 추가할 수 있나요?

예. 번들로 제공되는 Claude Code Skill(skills/send-sms/SKILL.md)은 어시스턴트에게 send_otp 및 verify_otp을 호출할 시기와 기존 회원가입 또는 로그인 경로에 인증 단계를 래핑하는 방법을 가르칩니다. *"/signup에 전화 인증 추가"*와 같은 프롬프트로 충분합니다.

소스 코드가 공개되어 있나요?

예, MIT 라이선스입니다. 서버, 7가지 도구 구현, npm 런처(@sms8/mcp), Claude Code 플러그인 매니페스트 및 예제 코드가 이 저장소에 있습니다.

내 API 키는 어떻게 되나요?

API 키는 Authorization: Bearer 헤더(또는 X-Api-Key)를 통해 각 MCP 도구 호출을 인증합니다. 호스팅 서버는 이를 SMS8 계정에 대해 검증한 다음, 기존 SMS8 전송 파이프라인을 통해 호출을 라우팅합니다. setup_sms8 응답은 키의 마지막 4자만 반환하므로 AI 채팅 기록이나 로그에 절대 유출되지 않습니다.

프로덕션 환경에서 사용해도 안전한가요?

예. 서버 측 방어에는 다음이 포함됩니다:

• SMS8 API에서 상속된 키별 속도 제한
• 전화번호당 24시간 동안 최대 5개의 OTP로 하드 캡, 사용자 구성 불가
• 30~600초의 재전송 쿨다운 (기본값 60초)
• POST 전용 OTP 엔드포인트; GET은 405 반환; 쿠키 무시
• 행 잠금을 통한 트랜잭션 래핑 속도 제한 확인; 동시 호출이 제한을 초과할 수 없음
• HMAC-SHA256 웹훅 서명
• RFC1918, CGNAT, 링크 로컬, IPv4 매핑 IPv6 및 DNS 확인 호스트를 포함하는 create_webhook의 포괄적인 SSRF 차단 목록
• 검색 메서드에만 CORS 광고; tools/call은 CORS를 생략하여 악성 웹 페이지가 SMS 전송을 구동할 수 없음

MCP 서버를 자체 호스팅할 수 있나요?

예. 저장소를 클론하고 SMS8_APP_PATH을 SMS8 설치 디렉터리로 설정한 후 실행하세요:

git clone https://github.com/1fancy/sms8-sms-gateway.git
cd sms8-sms-gateway
export SMS8_APP_PATH=/path/to/your/sms8-install
php -S 127.0.0.1:8080 index.php

mcp.sms8.io의 호스팅 서버는 무료이며 대부분의 사용자에게 더 쉽습니다.

"바이브 코딩"이란 무엇인가요?

바이브 코딩은 모든 줄을 직접 작성하는 대신 원하는 것을 평이한 영어로 AI 어시스턴트에게 설명하여 작동하는 소프트웨어를 출시하는 것입니다. SMS8 MCP는 가장 일반적인 요청 중 하나("SMS 알림 추가")를 통신사 포털이나 A2P 서류 작업을 전혀 건드리지 않고 가능하게 합니다.

보안 및 비밀

이 저장소에는 비밀이 포함되어 있지 않습니다. 모든 자격 증명은 환경 변수 또는 AI 도구의 MCP 구성에 저장됩니다:

SMS8_API_KEY=sk_…        # from app.sms8.io → Profile → API
SMS8_WEBHOOK_SECRET=…    # from app.sms8.io → Webhook

전체 보안 세부 정보는 위의 FAQ 섹션을 참조하세요. 별도의 보안 감사 요약은 요청 시 제공됩니다.

저장소 레이아웃

.
├── README.md                       this file
├── LICENSE                         MIT
├── index.php                       MCP server entry (JSON-RPC dispatcher)
├── landing.html                    marketing landing at mcp.sms8.io
├── .claude-plugin/plugin.json      Claude Code plugin manifest
├── .mcp.json                       MCP server config referenced by the plugin
├── skills/send-sms/SKILL.md        teaches Claude when to invoke SMS8 tools
├── npm-packages/                   five published npm packages
│   ├── sms8-mcp/                   MCP stdio bridge (sms8-mcp)
│   ├── sms8-cli/                   universal CLI (sms8)
│   ├── sms-otp-using-myphone/      OTP-only brand of the CLI
│   ├── phone-sms-gateway/          phone-as-gateway brand of the CLI
│   └── send-sms-from-android/      Android-first brand of the CLI
├── lib/                            Auth, JsonRpc, ToolRegistry
├── tools/                          7 tool implementations
└── examples/                       PHP and JS drop-in samples

로드맵

• mcp.sms8.io에서 HTTP MCP 서버 라이브
• 전화번호별 남용 제한이 있는 OTP 엔드포인트
• npm 패키지 sms8-mcp, sms8-cli, sms-otp-using-myphone, phone-sms-gateway, send-sms-from-android
• Claude Code 플러그인 및 Skill
• MMS 지원
• AI 응답 생성을 위한 수신 SMS 자동 라우팅
• 대시보드에서 구성 가능한 도구별 속도 제한
• Python, Go, Ruby 코드 예제

기여

이슈 및 풀 리퀘스트는 github.com/1fancy/sms8-sms-gateway에서 환영합니다. 큰 변경 전에 논의를 시작하세요.

라이선스

MIT. LICENSE 참조.

키워드

모델 컨텍스트 프로토콜, mcp 서버, mcp sms, claude code sms, claude code mcp, cursor mcp, windsurf mcp, sms api, otp api, sms 게이트웨이, android sms 게이트웨이, twilio 대안, 바이브 코딩, ai sms 통합, sms 알림, claude에서 sms 보내기, cursor에서 sms 보내기, 전화 인증 api, sms otp, 2fa sms, 웹훅 sms, 수신 sms, 양방향 sms, 무제한 sms, 메시지당 요금 없음, A2P 10DLC 없음, ai 코딩 도구, sms8