Clicksend

🚀 ClickSend MCP サーバー

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

✨ 主な機能

• SMS 送信：世界中の任意の電話番号に SMS メッセージを送信できます。
• テキスト読み上げ通話：カスタムの TTS メッセージを使用して音声通話を開始できます。
• レート制限：内蔵の保護機能で、1分間に最大5回の操作まで制限されます。
• 入力検証：電話番号とメッセージ内容の全面的な検証を行います。
• エラー処理：詳細なエラー情報と適切なエラー伝播を行います。

📦 インストール

前提条件

• Node.js (v16 以上)
• API 認証情報付きの ClickSend アカウント
• MCP 互換クライアント

セットアップ

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

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. send_sms

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

パラメータ：

• to：E.164 形式の電話番号（例：+61423456789）
• message：送信するメッセージ内容

例：

{
  "name": "send_sms",
  "arguments": {
    "to": "+61423456789",
    "message": "ClickSend MCP からの挨拶！"
  }
}

2. make_tts_call

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

パラメータ：

• to：E.164 形式の電話番号
• message：音声に変換するテキスト内容
• voice：音声の種類（'female' または 'male'、デフォルトは 'female'）

例：

{
  "name": "make_tts_call",
  "arguments": {
    "to": "+61423456789",
    "message": "これはテストメッセージです。",
    "voice": "female"
  }
}

📚 ドキュメント

スクリプトコマンド

• npm パッケージを初期化します：

npm init -y

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

npm install

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

npm run build

🔜 今後の予定

完了済み

• [x] 基本的な SMS 送信機能の実装
• [x] テキスト読み上げ通話のサポート追加
• [x] レート制限機能の統合
• [x] 入力検証ロジックの完成
• [x] 詳細なエラー処理の実装

未実施

• [ ] ログ記録機能の追加
• [ ] 多言語出力のサポート
• [ ] 高度なセキュリティ対策の実装
• [ ] 自動化テストの追加

📄 ライセンス

MIT

貢献ガイド

貢献を歓迎します！Pull Request をいつでも送信してください。