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、双向消息，或为自主 Agent 验证手机号？大多数方案都要求你注册运营商计划、申请电话号码、按消息付费，或按会话租用一次性 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 控制面板相同的发送流程。额度、重试、多设备路由和 Webhook 签名的工作方式与直接调用 API 完全一致。

SMS8 与 Twilio 和 MessageBird 的比较

功能	SMS8	Twilio	MessageBird
内置 MCP 服务	是	否	否
单条消息费用	无	$0.0079+	$0.05+
是否需要 A2P 10DLC	否	是	是
电话号码申请	无需	$1+/月	$2+/月
设置时间	60 秒	数天至数周	数天
内置 OTP 验证	是	需额外服务	需额外服务
开源 MCP 代码	MIT	否	否

通过 npm 安装

六个包涵盖所有工作流 — 选择适合你项目的包。

包	运行命令	使用场景
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”搜索优化的名称
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"	同一 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')}
/>

这六个包的源码都位于 npm-packages/。

iOS + Android SDK

对于原生移动应用，sdks/ 文件夹提供 Kotlin（Android）和 Swift（iOS）SDK，包含 发送 / 验证 API 和 短信自动填充辅助功能（Android 上的 Google SMS Retriever，iOS 上的 oneTimeCode 内容类型）。

SDK	安装	自动填充
sms8-swift	Swift Package Manager — 参见 README	iOS OTPTextField SwiftUI 视图
sms8-android	JitPack — 参见 README	SMSRetriever.start(activity) — 无需短信权限

两个 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 插件（一条命令）

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

然后在启动 Claude Code 前，在 shell 中运行 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 码，并提供实时短信测试表单。

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.

通过短信无密码登录

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

管理页面的短信双重身份验证

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：精简的 Sms8Sender 类，包含 send、sendOtp、verifyOtp
• js-fetch.js：Node／浏览器／Cloudflare Worker 客户端（ESM 和 CommonJS）
• otp-flow.php：完整的手机号验证流程（startSignup + verifySignup）
• webhook-handler.php：带 HMAC 签名检查的入站短信处理程序

常见问题

SMS8 MCP 服务是什么？

这是一个位于 mcp.sms8.io 的 HTTPS 端点，实现了模型上下文协议。AI 编码工具通过其 JSON-RPC 接口发送短信、发送 OTP 并配置 Webhook。短信通过 SMS8 平台，经由配对的 Android 手机发送。

这与 Twilio 有什么不同？

SMS8 使用你自己的 Android 手机作为网关，并使用现有的 SIM 卡。没有按条收取的运营商费用，无需进行 A2P 10DLC 注册，也无需配置电话号码。你只需支付固定套餐费用，即可无限发送短信。MCP 服务提供 7 个工具，AI 助手可直接调用，而 Twilio 不提供此功能。

这能与 Claude Code 配合使用吗？

可以。将 MCP 服务添加到 ~/.config/claude/mcp-servers.json，使用指向 https://mcp.sms8.io 的 HTTP 传输，并将 SMS8 API 密钥作为 Bearer 令牌。或者运行 /plugin marketplace add 1fancy/sms8-sms-gateway，然后运行 /plugin install sms8-sms-gateway。

这能与 Cursor 和 Windsurf 配合使用吗？

可以。两者都支持 HTTP MCP 服务。将 https://mcp.sms8.io 和你的 API 密钥作为 Bearer 标头，添加到 ~/.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 密钥会怎样处理？

每次 MCP 工具调用都会通过 Authorization: Bearer 标头（或 X-Api-Key）使用你的 API 密钥进行身份验证。托管服务会根据你的 SMS8 账户验证密钥，然后通过现有的 SMS8 发送流程路由调用。setup_sms8 响应只会返回密钥的最后 4 个字符，因此密钥绝不会泄露到 AI 聊天记录或日志中。

在生产环境中使用安全吗？

安全。服务端防护包括：

• 沿用 SMS8 API 的按密钥速率限制
• 每个电话号码每 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，因此恶意网页无法触发短信发送

我可以自托管 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

如需了解完整的安全详情，请参阅上方的常见问题解答部分。可按需提供单独的安全审计摘要。

代码库布局

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

路线图

• HTTP MCP 服务已在 mcp.sms8.io 上线
• OTP 端点，带有每个电话号码的滥用限制
• npm 包 sms8-mcp、sms8-cli、sms-otp-using-myphone、phone-sms-gateway、send-sms-from-android
• Claude Code 插件和 Skill
• 支持 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