Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone

SMS8 MCP サーバー

SMS ゲートウェイ → sms8.io  ·  バイブコーディングを行うコーダーと開発者向けの SMS Gateway MCP → mcp.sms8.io

Claude Code、Cursor、Windsurf、OpenCode、その他 Model Context Protocol に対応する AI コーディングツールから、SMS の送信、OTP の発行と検証、受信コードの待機、Webhook の設定を行えます。SMS は SMS8 プラットフォームを経由し、ペアリング済みの Android スマートフォンから送信されます。

ライブサーバー： https://mcp.sms8.io ダッシュボード： https://app.sms8.io マーケティングサイト： https://sms8.io

これを使う理由

アプリを構築していて、SMS 通知、OTP、双方向メッセージング、自律型エージェントによる電話番号認証が必要ですか？多くのサービスでは、通信事業者のプログラムへの登録、電話番号の用意、メッセージごとの支払い、またはセッションごとの使い捨て SIM のレンタルが必要です。SMS8 は、すでにお持ちのスマートフォンを経由して SMS を送信します。MCP サーバーは、AI アシスタントが直接呼び出せる 9 つのツールを提供するため、プロジェクトへの SMS の追加に必要なのは、1 時間の統合作業ではなく、1 つのプロンプトだけです。

利用できる機能

ツール	目的
setup_sms8	API キーを検証し、アカウント情報とコードサンプルを返します
send_sms	ペアリング済みの Android デバイスから SMS を 1 通送信します
send_otp	認証コードを生成して送信します
verify_otp	入力されたコードを、直近に発行された OTP と照合します
wait_for_otp	新機能。 ペアリング済みの Android に OTP が届くまで待機し、コードを抽出します
get_messages	受信または送信した SMS のうち、最近のものを返します
list_devices	ペアリング済みの Android デバイスを一覧表示します
get_balance	新機能。 クレジットと更新状況を簡単に確認します
create_webhook	受信 SMS と配信イベント用のコールバック URL を登録します

すべてのツールで、SMS8 ダッシュボードと同じ送信パイプラインを利用します。クレジット、再試行、複数デバイスへのルーティング、Webhook 署名は、API を直接呼び出す場合と同じように機能します。

SMS8 と Twilio、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 ＋ Web フォールバック
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"	Android を主軸とした同じ CLI のブランド

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 スマートフォンをペアリングし、Profile then 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 プラグイン（コマンド 1 つ）

/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 に貼り付けて使える、実際の 1 行プロンプトです。

サインアップ時の電話番号認証

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/ 内の各ファイルは、本番環境ですぐに使える、依存関係ゼロのコピー＆ペースト可能なコードです。これらは、setup_sms8 ハンドシェイク後に AI が生成するコードです。

• 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 サーバーとは何ですか？

Model Context Protocol を実装する mcp.sms8.io の HTTPS エンドポイントです。AI コーディングツールは、その JSON-RPC インターフェースを呼び出して、SMS の送信、OTP の発行、Webhook の設定を行います。SMS は SMS8 プラットフォーム経由で、ペアリングされた Android スマートフォンから送信されます。

Twilio とはどう違いますか？

SMS8 では、お使いの Android スマートフォンを既存の SIM カードとともにゲートウェイとして使用します。メッセージごとの通信事業者手数料、A2P 10DLC 登録、プロビジョニングが必要な電話番号はありません。定額プランで SMS を無制限に送信できます。MCP サーバーは、AI アシスタントが直接呼び出せる 7 つのツールを提供しますが、Twilio にはこの機能がありません。

Claude Code で使えますか？

はい。HTTP トランスポートを https://mcp.sms8.io に向け、SMS8 API キーを Bearer トークンとして指定して、MCP サーバーを ~/.config/claude/mcp-servers.json に追加してください。または、/plugin marketplace add 1fancy/sms8-sms-gateway に続けて /plugin install sms8-sms-gateway を実行してください。

Cursor や Windsurf で使えますか？

はい。どちらも HTTP MCP サーバーに対応しています。API キーを Bearer ヘッダーとして指定し、https://mcp.sms8.io を ~/.cursor/mcp.json（Cursor）または ~/.codeium/windsurf/mcp_config.json（Windsurf）に追加してください。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 から引き継いだキーごとのレート制限
• 1 つの電話番号につき 24 時間で最大 5 件の OTP。ユーザーによる変更は不可
• 30～600 秒の再送クールダウン（デフォルトは 60 秒）
• OTP エンドポイントは POST のみ。GET は 405 を返し、Cookie は無視されます
• 行ロックを使用したトランザクション内でのレート制限チェック。並行呼び出しによって制限を回避することはできません
• HMAC-SHA256 Webhook 署名
• create_webhook における包括的な SSRF ブロックリスト。RFC1918、CGNAT、リンクローカル、IPv4 マップド IPv6、DNS 解決されたホストを対象とします
• CORS はディスカバリーメソッドにのみ設定されます。tools/call では CORS を省略し、悪意ある Web ページから 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 プラグインとスキル
• MMS サポート
• 受信 SMS を AI に自動ルーティングし、返信を生成
• ダッシュボードでツールごとのレート制限を設定可能に
• Python、Go、Ruby のコード例

コントリビューション

github.com/1fancy/sms8-sms-gateway で、イシューやプルリクエストを歓迎します。大きな変更を行う場合は、事前にディスカッションを開始してください。

ライセンス

MIT。LICENSE を参照してください。

キーワード

model context protocol, mcp server, mcp sms, claude code sms, claude code mcp, cursor mcp, windsurf mcp, sms api, otp api, sms gateway, android sms gateway, twilio alternative, vibe coding, ai sms integration, sms notifications, send sms from claude, send sms from cursor, phone verification api, sms otp, 2fa sms, webhook sms, inbound sms, two-way sms, unlimited sms, no per-message fees, no A2P 10DLC, ai coding tools, sms8