SV Number MCP Server:让 AI Agent 自己完成全球短信验证
SV Number MCP Server:让 AI Agent 自己完成全球短信验证
SV Number MCP Server 是近期 GitHub Trending 上的一个小型热门项目,它解决了一个具体但高频的需求:给 AI Agent 装备「租手机号收短信验证码」的能力——在 200+ 国家自助下单虚拟号、轮询短信内容、完成平台注册,整个链路无需人工介入。截至 2026-08-28,项目在 GitHub 获星约 560 颗,正处于高速增长期,周增速达 213.9%,是当前 MCP 生态里增长最快的工具类 MCP Server 之一。
功能与设计原则
核心设计原则是「把接码做成 Agent 的标准工具」。项目提供 9 个 MCP 工具,覆盖从查余额、查国家、查服务、下单、等待短信到完成激活的完整链路。工具命名直接映射业务操作,不需要写 SDK,不需要理解底层 API 的分页或轮询逻辑——调工具就能干活。
关键设计细节:API 返回的非 JSON 文本标记(如 NO_NUMBERS)会被转成 Agent 可理解的自然语言指令(如「换个国家,或把 operator 设为 any」);轮询按合理间隔执行而非狂打 getStatus;wait_for_code 在号码 20 分钟生命周期内自动停止。
认可度
GitHub 星数约 560(截至 2026-08-28),周增速 213.9%。虽绝对数字不大,但增长曲线陡峭,属于典型「精准解决一个问题」的细分工具。ClaudeWave Trust Score 87/100(Trusted),通过安全扫描(npm audit、pip audit、prompt injection 检测均 PASSED)。在 LinkedIn 和 AGI Hunt 社区有实测讨论。
链接
GitHub:https://github.com/sv-number/mcp-server
原作者
sv-number 团队,背后运营一个商业接码平台 sms-verification-number.com,提供 200+ 国家的虚拟号租赁服务。GitHub 上同时维护了配套的 Python Agent Skill 库(sv-number/skills),进一步降低接入门槛。
介绍
这个 MCP Server 把接码平台的 API 封装成了 Agent 可直接调用的标准工具。对于需要在各类平台批量注册账号的 AI Agent 工作流来说,传统方案是人工介入或自行对接接码 API——前者无法自动化,后者接入成本高。SV Number 的思路是:把「租号→等码→确认」这三个步骤抽象成 MCP 工具,Agent 只需调 order_number、wait_for_code、finish_activation 三步即可完成一次完整的短信验证流程。
项目用 TypeScript 编写,通过 stdio 与 MCP 客户端通信,适配 Claude Code、Codex、Cursor、Windsurf、Claude Desktop 等所有兼容 MCP 协议的工具。9 个工具分别是:get_balance(查余额)、list_countries(列出 200+ 国家及编号)、list_services(按名称或域名查服务编码和价格)、order_number(下单)、wait_for_code(轮询短信并解析出验证码)、finish_activation(完成激活)、cancel_activation(取消退款)、request_another_sms(重发一条)、totp_code(本地计算 RFC 6238 动态口令)。
特点
- 200+ 国家覆盖:全行业最宽,单次
list_countries调用即可验证 - 零 SDK 学习成本:9 个工具覆盖全链路,Agent 直接调工具名称即可
- 多客户端即插即用:Claude Code 一行命令安装,Codex/Cursor/Claude Desktop JSON 配置即可
- 错误处理友好:API 返回的非结构化文本被转成自然语言提示,Agent 知道下一步怎么走
- 安全性合规:API Key 仅读环境变量,不通过工具返回,不在错误信息里明文打印;通过 prompt injection 安全扫描
使用方法
安装(Claude Code):
claude mcp add sv-number --env SVN_API_KEY=your_key_here -- npx -y sv-number-mcp
安装(Codex / Cursor / Claude Desktop):
在 MCP 配置文件里加入:
{
"mcpServers": {
"sv-number": {
"command": "npx",
"args": ["-y", "sv-number-mcp"],
"env": { "SVN_API_KEY": "your_key_here" }
}
}
}
获取 API Key:
在 sms-verification-number.com 注册并充值(无免费层级,按次计费起步 $0.10)。
最小调用示例:
order_number(service="tg", country=6)
→ +62 838 1234 5678
wait_for_code(activationId)
→ 123456
finish_activation(activationId)
→ done
使用场景与人群
适用于需要在全球各平台批量注册账号的 AI Agent 场景:社媒管理工具、竞品情报爬虫、多地区账号矩阵、自动化测试注册流程等。目标用户是 AI 工程师和自动化工作流开发者,尤其在需要跨地区注册 Telegram、Discord、各类电商平台等场景下价值明显。
不适用场景: 银行、支付、政府类需要真实实名手机号的验证(项目 README 明确说明);需要永久持有号码进行对话的场景。
输入与输出案例
案例一:注册 Telegram 账号
输入:order_number(service="tg", country=86)
输出:+86 138 1234 5678
输入:wait_for_code(activationId=12345)
输出:847291
输入:finish_activation(activationId=12345)
输出:done
案例二:查询可用国家与价格
输入:list_countries()
输出:[{"id":6,"country":"Indonesia","operators":[...]},{"id":86,"country":"China",...},...](200+国家列表)
输入:list_services(query="airbnb")
输出:[{"code":"uk","name":"Airbnb","price":0.6,"online":12,"deliveredPercent":94}]
评论区
登录后可评论。