Clicksend MCP Server

🚀 ClickSend MCP サーバー

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

🚀 クイックスタート

この ClickSend MCP サーバーを使用することで、AI モデルが SMS メッセージの送信や音声通話の開始をプログラムで行えます。以下に、サーバーの特性、インストール方法、使用方法などを説明します。

✨ 主な機能

• SMS 機能：世界中の任意の電話番号に SMS メッセージを送信できます。
• テキスト読み上げ通話：カスタマイズ可能なテキスト読み上げメッセージで音声通話を開始できます。
• レート制限：1 分間に 5 回の操作に制限する組み込み保護機能があります。
• 入力検証：電話番号とメッセージ内容の包括的な検証を行います。
• エラー処理：詳細なエラー情報と適切なエラー伝播が行われます。

📦 インストール

前提条件

• Node.js (v16 以上)
• ClickSend アカウントと API 認証情報
• 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": "你好，这是一条测试消息。"
  }
}

2. send_call

TTS を使用して音声通話を開始します。 パラメータ：

• to：E.164 形式の電話番号（例：+61423456789）
• message：TTS で読み上げるテキスト内容

例：

{
  "name": "send_call",
  "arguments": {
    "to": "+61423456789",
    "message": "你有一条新消息，请查阅。"
  }
}

🔧 技術詳細

• SMS と音声通話の双方向通信をサポートしています。
• ClickSend の API 機能を統合しています。
• 詳細なログ記録とエラー処理メカニズムを提供しています。

📄 ライセンス

MIT

貢献

貢献を歓迎します！自由に Pull Request を送信してください。