ClickSend MCP サーバー

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

特徴

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

Related MCP server: Slack MCP Server

インストール

前提条件

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