SMS Vert Pro — Python & TypeScript

SMS Vert Pro — Python MCP 服务

使用 Python 编写的 MCP（Model Context Protocol） 服务，可通过 SMS Vert Pro 从任意 AI Agent 发送专业短信：Claude、ChatGPT、LangChain、CrewAI、AutoGen 等。

另有 TypeScript/Node.js（npx @3-bees-online/mcp-server-smsvertpro）和 PHP 版本

前提条件

1. Python 3.10+
2. SMS Vert Pro 账户 — 免费注册（赠送 10 条短信）
3. Bearer API 令牌 — 在账户的 V2 API 中生成

安装

git clone https://github.com/3-bees-online/mcp-server-smsvertpro-python.git
cd mcp-server-smsvertpro-python
pip install -r requirements.txt

配置

将 API 令牌设置为环境变量：

export SMSVERTPRO_API_TOKEN="votre_token_api_ici"

Claude Desktop

在 claude_desktop_config.json 文件中添加：

{
  "mcpServers": {
    "smsvertpro": {
      "command": "python",
      "args": ["/chemin/vers/server.py"],
      "env": {
        "SMSVERTPRO_API_TOKEN": "votre_token_api_ici"
      }
    }
  }
}

Claude Code（CLI）

claude mcp add smsvertpro -- python /chemin/vers/server.py

然后配置环境变量 SMSVERTPRO_API_TOKEN。

Cursor / Windsurf

在编辑器设置中添加 MCP 配置，指向 python server.py，并设置环境变量 SMSVERTPRO_API_TOKEN。

可用工具

工具	描述
send_sms	发送短信（立即发送或定时发送）
check_credits	查看剩余积分
get_delivery_report	查看营销活动的送达报告
get_responses	查看收到的短信回复（双向）
verify_number	验证号码格式（语法）
get_blacklist	退订名单（STOP）
generate_otp	通过短信发送 OTP 验证码
verify_otp	验证 OTP 验证码
cancel_sms	取消定时短信或营销活动

使用示例

连接 MCP 服务后，只需向 AI Agent 提出请求：

• “给 33612345678 发送一条短信，宣布我们的春季促销优惠 8 折”
• “我还剩多少短信积分？”
• “检查营销活动 12345 的短信是否已送达”
• “给 33698765432 发送 OTP 验证码以确认注册”

AI Agent 将自动使用正确的工具和参数。

号码格式

电话号码必须采用不带 + 的国际格式：

• 法国：33612345678（不能是 0612345678，也不能是 +33612345678）
• 比利时：32470123456
• 瑞士：41791234567

安全

• 所有 API 调用均启用 SSL 验证
• 验证电话号码（格式、长度）
• 验证发件人名称（字母数字，最多 11 个字符）
• 验证 OTP 验证码（只能包含数字）
• API 令牌保留在你的计算机上，不会与 AI Agent 共享
• 服务仅与 https://www.smsvertpro.com/api/v2/ 通信
• 发送营销短信时，请在消息末尾添加 STOP 36173（法律要求）

链接

• SMS Vert Pro
• V2 API 文档
• AI 集成
• 短信资费
• PHP 版本

许可证

MIT — 查看 LICENSE