SMS8 - SMS GATEWAY using your phone

Máy chủ MCP SMS8

Cổng SMS → sms8.io  ·  Cổng SMS MCP cho lập trình viên vibe & nhà phát triển → mcp.sms8.io

Gửi SMS, tạo và xác minh OTP, chờ mã đến, và cấu hình webhook từ Claude Code, Cursor, Windsurf, OpenCode và bất kỳ công cụ lập trình AI nào hỗ trợ Model Context Protocol. SMS được định tuyến qua điện thoại Android đã ghép nối thông qua nền tảng SMS8.

Máy chủ trực tiếp: https://mcp.sms8.io Bảng điều khiển: https://app.sms8.io Trang tiếp thị: https://sms8.io

Tại sao nên sử dụng

Đang xây dựng ứng dụng và muốn có thông báo SMS, OTP, nhắn tin hai chiều, hoặc xác minh điện thoại cho tác nhân tự động? Hầu hết các lựa chọn buộc bạn phải đăng ký với chương trình nhà mạng, cấp số điện thoại, trả phí theo tin nhắn, hoặc thuê SIM dùng một lần cho mỗi phiên. SMS8 định tuyến SMS qua điện thoại bạn đã sở hữu. Máy chủ MCP cung cấp cho trợ lý AI của bạn chín công cụ có thể gọi trực tiếp, vì vậy việc thêm SMS vào dự án chỉ cần một lời nhắc thay vì một giờ tích hợp.

Những gì bạn nhận được

Công cụ	Mục đích
setup_sms8	Xác thực khóa API, trả về ngữ cảnh tài khoản và mẫu mã
send_sms	Gửi một SMS qua thiết bị Android đã ghép nối
send_otp	Tạo và gửi mã xác minh
verify_otp	So sánh mã đã nhập với OTP mới nhất đã phát hành
wait_for_otp	MỚI. Chặn cho đến khi OTP đến trên Android đã ghép nối; trích xuất mã
get_messages	Trả về SMS hộp thư đến hoặc đã gửi gần đây
list_devices	Liệt kê các thiết bị Android đã ghép nối
get_balance	MỚI. Kiểm tra tín dụng và gia hạn nhẹ
create_webhook	Đăng ký URL callback cho SMS đến và sự kiện gửi

Tất cả các công cụ chia sẻ cùng đường ống gửi như bảng điều khiển SMS8. Tín dụng, thử lại, định tuyến đa thiết bị, và ký webhook hoạt động giống hệt như gọi API trực tiếp.

SMS8 so với Twilio so với MessageBird

Khả năng	SMS8	Twilio	MessageBird
Máy chủ MCP tích hợp	Có	Không	Không
Phí mỗi tin nhắn	Không	$0.0079+	$0.05+
Yêu cầu A2P 10DLC	Không	Có	Có
Cấp số điện thoại	Không cần	$1+/tháng	$2+/tháng
Thời gian thiết lập	60 giây	Vài ngày đến vài tuần	Vài ngày
Xác minh OTP tích hợp	Có	Dịch vụ thêm	Dịch vụ thêm
Mã MCP nguồn mở	MIT	Không	Không

Cài đặt qua npm

Sáu gói bao phủ mọi luồng — chọn gói phù hợp với dự án của bạn.

Gói	Lệnh chạy	Trường hợp sử dụng
sms8-mcp	npx -y sms8-mcp	Trình khởi chạy MCP cho Claude Code, Cursor, Windsurf, OpenCode
sms8-cli	npx sms8-cli send +1234 "hi"	CLI đầu cuối cho gửi / OTP / hộp thư đến / thiết bị
react-sms-otp	npm i react-sms-otp	React useSms8Otp() + <OtpForm /> + <OtpInput /> (dấu phân cách, RTL, mặt nạ, render props)
sms-otp-verify	npm i sms-otp-verify	Cùng mã, tên nhắm SEO cho tìm kiếm "sms otp verify" / "otp input"
capacitor-sms-otp-send-verify	npm i capacitor-sms-otp-send-verify	Plugin Capacitor cho ứng dụng Ionic — iOS Swift + Android Kotlin gốc + dự phòng web
cordova-plugin-sms-otp-send	cordova plugin add cordova-plugin-sms-otp-send	Plugin Cordova cho ứng dụng Ionic — iOS Swift + Android Kotlin gốc
sms-otp-using-myphone	npx sms-otp-using-myphone send +1234	Thương hiệu chỉ OTP của cùng CLI
phone-sms-gateway	npx phone-sms-gateway send +1234 "hi"	Thương hiệu điện thoại làm cổng của cùng CLI
send-sms-from-android	npx send-sms-from-android send +1234 "hi"	Thương hiệu ưu tiên Android của cùng CLI

Ví dụ MCP (Claude Code, Cursor, Windsurf — cùng hình dạng cấu hình):

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

Ví dụ CLI:

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

Ví dụ React:

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

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

Mã nguồn cho tất cả sáu gói nằm trong npm-packages/.

SDK iOS + Android

Đối với ứng dụng di động gốc, thư mục sdks/ cung cấp SDK Kotlin (Android) và Swift (iOS) với API gửi / xác minh + trình trợ giúp tự động điền SMS (Google SMS Retriever trên Android, loại nội dung oneTimeCode trên iOS).

SDK	Cài đặt	Tự động điền
sms8-swift	Swift Package Manager — xem README	iOS OTPTextField SwiftUI view
sms8-android	JitPack — xem README	SMSRetriever.start(activity) — không cần quyền SMS

Cả hai SDK đều MIT, chia sẻ cùng khóa API SMS8, và nhắm đến các trường hợp sử dụng thay thế Twilio-Verify.

Bắt đầu nhanh

1. Tạo tài khoản SMS8

Đăng ký tại app.sms8.io. Dùng thử miễn phí 5 ngày, không cần thẻ tín dụng. Ghép nối điện thoại Android của bạn qua QR và sao chép khóa API từ Hồ sơ rồi API.

2. Thêm máy chủ MCP vào công cụ của bạn

HTTP được lưu trữ (Claude Code, Cursor, Windsurf, Codex, Devin)

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

Plugin Claude Code (một lệnh)

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

Sau đó export SMS8_API_KEY=sk_xxx trong shell của bạn trước khi khởi chạy Claude Code.

npx cho máy khách stdio

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

3. Trình hướng dẫn thiết lập

Bảng điều khiển tại app.sms8.io/mcp-setup.php điền sẵn JSON cho từng công cụ AI, hiển thị QR ghép nối thiết bị nếu cần, và bao gồm biểu mẫu kiểm tra SMS trực tiếp.

4. Hỏi AI của bạn

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

AI sẽ gọi setup_sms8, sau đó send_otp và verify_otp, và viết mã sản xuất hoạt động ngay lần đầu tiên.

Trường hợp sử dụng

Đây là những lời nhắc một dòng thực tế bạn có thể dán vào Claude Code, Cursor, hoặc Windsurf.

Xác minh điện thoại khi đăng ký

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.

Thông báo vận chuyển đơn hàng

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

Hộp thư hỗ trợ hai chiều

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.

Đăng nhập không mật khẩu bằng SMS

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

SMS 2FA cho trang quản trị

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

Ví dụ mã thả vào

Mỗi tệp trong examples/ sẵn sàng sản xuất, không phụ thuộc, và có thể sao chép-dán. Đây là những gì AI tạo ra sau khi bắt tay setup_sms8.

• php-send.php: lớp Sms8Sender tối thiểu với send, sendOtp, verifyOtp
• js-fetch.js: máy khách Node / trình duyệt / Cloudflare Worker (ESM và CommonJS)
• otp-flow.php: luồng xác minh điện thoại hoàn chỉnh (startSignup + verifySignup)
• webhook-handler.php: trình xử lý SMS đến với kiểm tra chữ ký HMAC

Câu hỏi thường gặp

Máy chủ MCP SMS8 là gì?

Một điểm cuối HTTPS tại mcp.sms8.io triển khai Model Context Protocol. Các công cụ lập trình AI gọi giao diện JSON-RPC của nó để gửi SMS, phát hành OTP, và cấu hình webhook. SMS được định tuyến qua điện thoại Android đã ghép nối thông qua nền tảng SMS8.

Điều này khác Twilio như thế nào?

SMS8 sử dụng điện thoại Android của chính bạn làm cổng với thẻ SIM hiện có. Không có phí nhà mạng mỗi tin nhắn, không cần đăng ký A2P 10DLC, và không cần cấp số điện thoại. Bạn trả một gói cố định và gửi SMS không giới hạn. Máy chủ MCP cung cấp bảy công cụ mà trợ lý AI của bạn có thể gọi trực tiếp, điều mà Twilio không cung cấp.

Điều này có hoạt động với Claude Code không?

Có. Thêm máy chủ MCP vào ~/.config/claude/mcp-servers.json với vận chuyển HTTP trỏ đến https://mcp.sms8.io và khóa API SMS8 của bạn làm token Bearer. Hoặc chạy /plugin marketplace add 1fancy/sms8-sms-gateway sau đó /plugin install sms8-sms-gateway.

Điều này có hoạt động với Cursor và Windsurf không?

Có. Cả hai đều hỗ trợ máy chủ MCP HTTP. Thêm https://mcp.sms8.io với khóa API của bạn làm tiêu đề Bearer vào ~/.cursor/mcp.json (Cursor) hoặc ~/.codeium/windsurf/mcp_config.json (Windsurf). Trình hướng dẫn thiết lập tại app.sms8.io/mcp-setup.php điền sẵn JSON cho từng công cụ.

AI có thể tự động thêm xác minh OTP không?

Có. Kỹ năng Claude Code đi kèm (skills/send-sms/SKILL.md) dạy trợ lý khi nào gọi send_otp và verify_otp, và cách bao bọc tuyến đăng ký hoặc đăng nhập hiện có với bước xác minh. Một lời nhắc như "thêm xác minh điện thoại vào /signup" là đủ.

Mã nguồn có công khai không?

Có, được cấp phép MIT. Máy chủ, tất cả bảy triển khai công cụ, trình khởi chạy npm (@sms8/mcp), tệp kê khai plugin Claude Code, và mã ví dụ nằm trong repo này.

Điều gì xảy ra với khóa API của tôi?

Khóa API của bạn xác thực mỗi lần gọi công cụ MCP thông qua tiêu đề Authorization: Bearer (hoặc X-Api-Key). Máy chủ được lưu trữ xác thực nó với tài khoản SMS8 của bạn, sau đó định tuyến cuộc gọi qua đường ống gửi SMS8 hiện có. Phản hồi setup_sms8 chỉ trả về bốn ký tự cuối của khóa, vì vậy nó không bao giờ rò rỉ vào lịch sử trò chuyện AI hoặc nhật ký.

Điều này có an toàn để sử dụng trong sản xuất không?

Có. Các biện pháp phòng thủ phía máy chủ bao gồm:

• Giới hạn tốc độ mỗi khóa kế thừa từ API SMS8
• Giới hạn cứng 5 OTP mỗi số điện thoại mỗi 24 giờ, không thể cấu hình bởi người dùng
• Thời gian chờ gửi lại từ 30 đến 600 giây (mặc định 60 giây)
• Điểm cuối OTP chỉ POST; GET trả về 405; bỏ qua cookie
• Kiểm tra giới hạn tốc độ được bao bọc giao dịch với khóa hàng; các cuộc gọi đồng thời không thể vượt qua giới hạn
• Chữ ký webhook HMAC-SHA256
• Danh sách chặn SSRF toàn diện trên create_webhook bao gồm RFC1918, CGNAT, link-local, IPv4-mapped IPv6, và máy chủ phân giải DNS
• CORS chỉ được quảng cáo cho phương thức khám phá; tools/call bỏ qua CORS để trang web độc hại không thể điều khiển gửi SMS

Tôi có thể tự lưu trữ máy chủ MCP không?

Có. Sao chép repo, đặt SMS8_APP_PATH vào thư mục cài đặt SMS8 của bạn, và chạy:

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

Máy chủ được lưu trữ tại mcp.sms8.io miễn phí và dễ dàng hơn cho hầu hết người dùng.

"Vibe coding" là gì?

Vibe coding là vận chuyển phần mềm hoạt động bằng cách mô tả những gì bạn muốn bằng tiếng Anh đơn giản cho trợ lý AI thay vì tự viết từng dòng. SMS8 MCP làm cho một trong những yêu cầu phổ biến nhất ("thêm thông báo SMS") có thể thực hiện mà không cần chạm vào cổng nhà mạng hay thủ tục A2P.

Bảo mật và bí mật

Kho lưu trữ này không chứa bí mật. Tất cả thông tin xác thực nằm trong biến môi trường hoặc cấu hình MCP của công cụ AI của bạn:

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

Để biết chi tiết bảo mật đầy đủ, xem phần FAQ ở trên. Một bản tóm tắt kiểm toán bảo mật riêng có sẵn theo yêu cầu.

Bố cục kho lưu trữ

.
├── 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

Lộ trình

• Máy chủ MCP HTTP trực tiếp tại mcp.sms8.io
• Điểm cuối OTP với giới hạn lạm dụng mỗi điện thoại
• Gói npm sms8-mcp, sms8-cli, sms-otp-using-myphone, phone-sms-gateway, send-sms-from-android
• Plugin Claude Code và Kỹ năng
• Hỗ trợ MMS
• SMS đến tự động định tuyến đến AI để tạo phản hồi
• Giới hạn tốc độ mỗi công cụ có thể cấu hình trong bảng điều khiển
• Ví dụ mã bằng Python, Go, và Ruby

Đóng góp

Vấn đề và yêu cầu kéo được chào đón tại github.com/1fancy/sms8-sms-gateway. Mở thảo luận trước khi thay đổi lớn.

Giấy phép

MIT. Xem LICENSE.

Từ khóa

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