SMS Vert Pro — Python & TypeScript

SMS Vert Pro — Python MCP サーバー

Python 製の MCP（Model Context Protocol） サーバーです。SMS Vert Pro を通じて、Claude、ChatGPT、LangChain、CrewAI、AutoGen など、あらゆる AI エージェントからビジネス SMS を送信できます。

TypeScript/Node.js（npx @3-bees-online/mcp-server-smsvertpro）および PHP 版も利用できます。

前提条件

1. Python 3.10+
2. SMS Vert Pro アカウント — 無料登録（SMS 10 通無料）
3. Bearer API トークン — アカウントの API V2 から生成してください

インストール

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 設定を追加し、環境変数 SMSVERTPRO_API_TOKEN を指定して python server.py を実行するように設定します。

利用可能なツール

ツール	説明
send_sms	SMS を送信します（即時または予約）
check_credits	クレジット残高を確認します
get_delivery_report	キャンペーンの配信レポートを取得します
get_responses	受信した SMS の返信を取得します（双方向）
verify_number	電話番号の形式を確認します（構文）
get_blacklist	配信停止（STOP）リストを取得します
generate_otp	SMS で OTP コードを送信します
verify_otp	OTP コードを確認します
cancel_sms	予約済み SMS またはキャンペーンをキャンセルします

使用例

MCP サーバーに接続したら、AI エージェントに次のように依頼するだけです。

• 「33612345678 に、春のキャンペーン 20% オフを知らせる SMS を送って」
• 「SMS クレジットはあといくつ残っていますか？」
• 「キャンペーン 12345 の SMS が配信されたか確認して」
• 「登録を確認するため、33698765432 に OTP コードを送って」

AI エージェントが適切なツールを適切なパラメーターで自動的に使用します。

電話番号の形式

電話番号は + を付けない国際形式で指定してください。

• フランス：33612345678（0612345678 や +33612345678 ではありません）
• ベルギー：32470123456
• スイス：41791234567

セキュリティ

• すべての API 呼び出しで SSL 検証が有効です
• 電話番号を検証します（形式、長さ）
• 送信者名を検証します（英数字、最大 11 文字）
• OTP コードを検証します（数字のみ）
• API トークンはお使いのマシン上に保持され、AI エージェントと共有されることはありません
• サーバーは https://www.smsvertpro.com/api/v2/ とのみ通信します
• マーケティング SMS では、メッセージの末尾に STOP 36173 を追加してください（法的義務）

リンク

• SMS Vert Pro
• API V2 ドキュメント
• AI 連携
• SMS 料金
• PHP 版

ライセンス

MIT — LICENSE をご覧ください。