SV Number MCP Server

SV Number MCP Server 是面向 AI Agent 的短信验证码接码工具，为需要手机号验证的自动化工作流提供完整解决方案。Agent 可以在任意国家购买临时私有号码、接收短信验证码并自动解析回传，全程无需人工介入，大幅提升需要手机号注册场景的自动化效率。

服务基于 commercial SMS verification API，MIT 开源协议保护服务端代码本身，但背后接码服务为商业付费服务（需从 sms-verification-number.com 充值余额，无免费额度）。Agent 端仅传输必要的国家/服务/手机号信息，SVN_API_KEY 存储在环境变量中不进入对话上下文，敏感信息不泄露。

MCP 服务器通过 stdio 暴露 9 个工具：get_balance 查询余额、list_countries 列出支持国家及其编号和运营商、list_services 按网站名或域名搜索对应验证码接收服务（含价格/在线数量/送达率排名）、order_number 订购一个临时号码、wait_for_code 轮询等待验证码到达并自动解析为纯数字返回、finish_activation 关闭成功激活的号码、cancel_activation 取消并退款、request_another_sms 申请同号码重新下发、totp_code 计算 TOTP 动态口令（RFC 6238）。

list_services 的搜索逻辑经过优化：网站名全匹配优先于子字符串匹配（如 x 优先返回 X.com 而非 x.com 相关内容），结果按送达率排序无送达率数据时看在线号码池大小。接码服务仅用于接收注册验证码，不发短信、不接电话、不适合银行/支付/政务类需要永久持有的场景——后者应使用正规通讯运营商产品。安装方式为 Claude Code 一行命令：claude mcp add sv-number --env SVN_API_KEY=xxx -- npx -y sv-number-mcp；也兼容 Cursor、Codex 等所有遵循 JSON 配置规范的 MCP 客户端。