remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides sending SMS messages and making Text-to-Speech calls via ClickSend's API, with features for phone number validation and rate limiting.

ClickSend MCP サーバー

ClickSend APIを介してSMSメッセージングと音声合成（TTS）通話機能を提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AIモデルはプログラムによってSMSメッセージを送信したり、音声通話を開始したりできるようになります。

特徴

SMSメッセージング：世界中のどの電話番号にもSMSメッセージを送信できます
音声合成通話: カスタマイズ可能な音声合成メッセージで音声通話を行えます
レート制限: 1分あたり5アクションの制限を備えた組み込みの保護
入力検証:電話番号とメッセージ内容の包括的な検証
エラー処理: 詳細なエラーメッセージと適切なエラー伝播

インストール

前提条件

Node.js (v16 以上)
API認証情報を持つClickSendアカウント
MCP対応クライアント

設定

リポジトリをクローンします。

git clone https://github.com/J-Gal02/clicksend-mcp.git
cd clicksend-mcp

依存関係をインストールします:

npm install

プロジェクトをビルドします。

npm run build

MCPクライアントの設定

cline_mcp_settings.jsonファイルまたはclaude_desktop_config.jsonファイルに次のセクションを追加します。

以下の例に示すように、ディレクトリをビルドフォルダーへの正しいパスに置き換え、ユーザー名と API キーを独自のものに置き換えてください。

{
    "mcpServers": {
        "clicksend": {
            "command": "node",
            "args": ["/directory/to/build/folder/clicksend-mcp/build/index.js"],
            "env": {
                "CLICKSEND_USERNAME": "example@droove.net",
                "CLICKSEND_API_KEY": "ZZZZZZZZ-YYYY-YYYY-YYYY-XXXXXXXXXXXX"
            }
        }
    }
}

使用法

利用可能なツール

1. SMSを送信する

指定された電話番号に SMS メッセージを送信します。

パラメータ:

to : E.164形式の電話番号（例: +61423456789）
message : 送信するテキスト内容

例：

{
  "name": "send_sms",
  "arguments": {
    "to": "+61423456789",
    "message": "Hello from ClickSend MCP!"
  }
}

2. make_tts_call

テキスト読み上げ通話を開始します。

パラメータ:

to : E.164形式の電話番号
message : 音声に変換するテキストコンテンツ
voice : 音声の種類（「女性」または「男性」、デフォルトは「女性」）

例：

{
  "name": "make_tts_call",
  "arguments": {
    "to": "+61423456789",
    "message": "This is a Text-to-Speech call from ClickSend MCP",
    "voice": "female"
  }
}

レート制限

サーバーは不正使用を防ぐため、1分あたり5アクションのレート制限を実装しています。この制限を超えるリクエストには、再試行の遅延を提案するエラーレスポンスが送信されます。

発達

利用可能なスクリプト

npm run build : TypeScriptをコンパイルし、出力を実行可能にする
npm run start : MCPサーバーを起動する
npm run dev : TypeScript コンパイラをウォッチモードで実行する

プロジェクト構造

clicksend-mcp/
├── src/
│   ├── index.ts        # Main server implementation
│   ├── client.ts       # ClickSend API client
│   └── utils/
│       └── validation.ts # Input validation utilities
├── build/              # Compiled JavaScript output
└── package.json        # Project configuration

エラー処理

サーバーは、さまざまなシナリオに対して詳細なエラーメッセージを提供します。

無効な電話番号
メッセージ内容の検証失敗
レート制限を超えました
API認証エラー
ネットワーク接続の問題

エラー応答には、問題の診断に役立つ適切なエラーコードと説明メッセージが含まれます。

やるべきこと

[ ] 複数の受信者
[ ] 送信者IDを設定する
[x] SMS
[x] TTS
[ ] メールアドレス
[ ] メディアのアップロード
- [ ] メールの添付ファイル
- [ ] MMS
- [ ] 文字
- [ ] ポストカード
- [ ] ファックス
[ ] コスト計算と確認
[ ] 統計
[ ] 歴史
[ ] 連絡先
[ ] 自動化

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

このサーバーにより、AI モデルは、レート制限と入力検証が組み込まれた ClickSend の API を使用して、プログラムで SMS メッセージを送信したり、テキスト読み上げ通話を開始したりできるようになります。

Related Resources

Reddit Discussion about this server

ClickSend MCP Server