sv-number-mcp

这是什么？适合谁？

sv-number MCP（sv-number/mcp-server）是一个为 AI Agent 提供真实手机号能力的 MCP Server。它让 AI Agent 可以订购 200+ 国家的私有号码、收发短信、管理号码生命周期——本质上是给 Agent 配了一个「真实世界的手机号」。

解决的问题：AI Agent 在自动化注册、验证、双因素认证（2FA）等场景中，最大的障碍是「没有自己的手机号」。sv-number MCP 填补了这个物理世界锚点——Agent 可以像人类一样接收验证码短信、完成账号注册。

适合人群：

• 需要 AI Agent 自动化注册/验证账号的开发者
• 构建 Agent 自动化工作流时需要短信验证环节的团队
• 测试多国家/地区短信服务的 QA 工程师
• 研究 Agent 与现实世界服务交互的从业者

不适合：不需要短信验证的纯文本/API 交互场景；以及需要批量群发短信的场景（这是 SMS 平台的功能，不是 sv-number 的定位）。

使用前提：sv-number 平台账号（需充值余额）；MCP 兼容客户端（Claude Code / Claude Desktop / Cursor 等）；对目标国家/地区的号码定价有基本了解。

准备工作

1. sv-number 账号：访问 sv-number 官网 注册并充值。号码价格因国家而异，从 $0.10 到 $5.00 不等，按使用时长计费。
2. API Token：在 sv-number 后台获取 API Token，用于 MCP Server 认证。
3. MCP 客户端：任意支持 Streamable HTTP 或 stdio 的 MCP 客户端。
4. 成本：工具本身开源免费（MIT）；号码费用按国家/时长从 sv-number 平台收取。
5. 时间预算：注册 + 配置 5 分钟；首次让 Agent 成功收发短信约 10 分钟。

快速上手（3 步）

第一步：安装 MCP Server

# 使用 npx 直接运行（推荐）
npx @sv-number/mcp-server --api-key YOUR_API_KEY

# 或全局安装
npm install -g @sv-number/mcp-server
sv-number-mcp --api-key YOUR_API_KEY

第二步：配置 MCP 客户端

在 Claude Desktop 的 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "sv-number": {
      "command": "npx",
      "args": ["@sv-number/mcp-server", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Claude Code 用户可通过 /mcp add 命令添加。

第三步：让 Agent 使用手机号

配置完成后，Agent 即可调用以下核心能力：

• 订购号码：指定国家/地区，Agent 自动下单购买私有号码
• 接收短信：Agent 等待并读取发送到该号码的短信（如验证码）
• 释放号码：使用完毕后 Agent 自动释放号码，停止计费

示例对话：

用户：帮我在 Twitter 注册一个账号 Agent：需要美国手机号接收验证码… 已订购号码 +1 (555) xxx-xxxx，等待验证码… 收到验证码 123456，正在完成注册… 注册成功！已释放号码。

初级用法

号码订购策略

• 按需订购：仅在需要时订购号码，减少不必要费用
• 国家选择：优先选择低价国家（如印尼、菲律宾通常 $0.10-0.50），在目标服务接受的前提下节省成本
• 时长管理：默认租用 20 分钟，超时自动续费或释放——对于验证码场景（通常 1-2 分钟）绰绰有余

常见服务适配

高级玩法

多 Agent 号码池

为多个并行 Agent 各分配独立号码，实现大规模并发注册：

# 伪代码：批量注册工作流
for agent in agents:
    number = sv_number.order_number(country="US")
    agent.register_service("twitter", phone=number)
    # Agent 自动完成注册后释放号码

号码黑名单过滤

部分服务会拒绝 VoIP/虚拟号码。sv-number 提供号码类型过滤，优先选择「真实 SIM 卡号码」提高验证通过率。注意：真实 SIM 号码价格通常比虚拟号码高 30-50%。

与 Agent 工作流编排集成

将 sv-number MCP 接入 n8n / Dify 等工作流引擎，实现「检测到需要手机验证 → 自动订购号码 → 接收验证码 → 填回表单 → 释放号码」的端到端自动化。

小技巧

1. 先测试后批量：在目标服务上用 1 个号码测试通过率，再批量操作
2. 余额预警：设置 sv-number 账户余额告警，避免 Agent 运行时因余额不足中断
3. 号码复用：部分服务允许同一号码注册多个账号，可在释放前尝试复用
4. 时区注意：某些国家号码在非工作时间可能延迟到达，尽量在目标国家白天操作
5. 验证码超时：默认等待 120 秒，若服务端延迟可适当延长

常见踩坑

踩坑 1：号码被目标服务拒绝

现象：Agent 订购号码后，目标服务提示「无效号码」或「不支持虚拟号码」

原因：该号码被服务商标记为虚拟号码/VoIP 号码

解决：切换号码类型为「真实 SIM 卡号码」，或更换国家。美国真实号码通常通过率最高但价格也最贵。

踩坑 2：验证码延迟到达

现象：Agent 等待超过 120 秒仍未收到短信

原因：国际短信路由延迟；或目标服务在非工作时间发送较慢

解决：延长等待超时到 300 秒；选择与目标服务同国家的号码减少路由延迟。

踩坑 3：余额消耗过快

现象：Agent 运行 30 分钟消耗了 $10+ 余额

原因：Agent 频繁订购-释放号码，每次订购都有最低消费

解决：优化 Agent 逻辑，在确认需要号码前不提前订购；使用后立即释放。

踩坑 4：API Token 泄露

现象：sv-number 账户出现异常消费

原因：API Token 被提交到公开仓库或泄露

解决：使用环境变量存储 Token；定期在 sv-number 后台轮换 Token；设置消费限额。

踩坑 5：MCP 连接中断导致号码未释放

现象：MCP 连接断开后，号码仍在计费

原因：Agent 异常退出时未执行释放操作

解决：在 sv-number 后台设置「最大租用时长」自动释放；Agent 重启后检测并释放未关闭的号码。

常见问题 FAQ

Q1: sv-number 和 Twilio 有什么区别？

A: Twilio 是面向开发者的通信 API 平台（发送短信、语音通话、视频），sv-number 是专门为 AI Agent 设计的「接收短信」工具。Twilio 也可以做号码验证，但 sv-number 的 MCP 原生集成让 Agent 可以直接调用，无需编写代码。如果你需要发送营销短信，用 Twilio；如果你需要让 Agent 接收验证码，用 sv-number。

Q2: 一个号码可以同时用于多个服务吗？

A: 可以。在号码租用期间，可以接收来自任意服务的短信。但注意部分服务会检测「号码是否已被用于注册其他账号」，存在风控风险。

Q3: 中国手机号支持吗？

A: sv-number 目前主要覆盖海外国家，中国号码支持有限。如需中国号码，建议使用国内短信接码平台。

Q4: 费用如何计算？

A: 按号码租用时长计费，不同国家价格不同（$0.10-5.00/次）。不按短信条数收费——租用期间收多少条短信都不额外收费。

Q5: Agent 能同时管理多个号码吗？

A: 可以。每个 MCP 会话可以同时持有多个号码，Agent 可以并行处理多个验证任务。

进阶学习建议

掌握 sv-number MCP 后，建议深入以下方向：

1. Agent 身份管理全链路：结合 Sentio（Agent 邮箱 API）和 sv-number，构建 Agent 的完整「身份证」——手机号 + 邮箱 + 身份信息，让 Agent 真正以「数字人」身份与世界交互。
2. 反反自动化策略：研究目标服务的风控机制（如检测浏览器指纹、IP 信誉、行为模式），结合 Playwright MCP 或 browser-use 让 Agent 的注册行为看起来更像真人。具体可关注 camoufox（反检测浏览器）和 fingerprint-suite 等工具。
3. 短信验证码解析：训练 Agent 识别不同语言、不同格式的验证码短信（如「您的验证码是 123456」「Your code: 123456」），建议维护一个验证码正则表达式库，覆盖中英日韩等主流语言。

参考链接

• 官方仓库
• sv-number 官网
• MCP 协议官方文档

最后更新：2026-08-26 · 作者：MagicNetWorld · 基于公开资料整理，AI 辅助生成