Clicksend

🚀 ClickSend MCP 服務器

ClickSend MCP 服務器是一個藉助 ClickSend API 實現短信發送和文本轉語音（TTS）呼叫功能的模型上下文協議（MCP）服務器。它讓 AI 模型能夠以編程方式發送 SMS 消息併發起語音通話，為相關業務場景提供了便捷的通信解決方案。

🚀 快速開始

ClickSend MCP 服務器允許 AI 模型通過編程方式發送 SMS 消息和發起語音通話。你可以按照以下步驟進行操作：

1. 完成安裝所需的先決條件，包括安裝 Node.js、準備 ClickSend 賬戶和 MCP 兼容客戶端。
2. 按照設置步驟克隆倉庫、安裝依賴項並構建項目。
3. 配置 MCP 客戶端，將必要的信息添加到配置文件中。
4. 根據使用說明，調用相應的工具發送短信或發起語音呼叫。

✨ 主要特性

• 短信發送：可向全球任何電話號碼發送 SMS 消息，實現廣泛的通信覆蓋。
• 文本轉語音呼叫：能使用自定義的 TTS 消息發起語音呼叫，滿足多樣化的語音通信需求。
• 速率限制：內置保護機制，每分鐘最多允許 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 消息。

{
  "name": "send_sms",
  "arguments": {
    "to": "+61423456789",
    "message": "來自 ClickSend MCP 的問候！"
  }
}

2. make_tts_call

發起文本轉語音呼叫。

{
  "name": "make_tts_call",
  "arguments": {
    "to": "+61423456789",
    "message": "這是一個測試消息。",
    "voice": "female"
  }
}

📚 詳細文檔

開發信息

腳本命令

• 初始化 npm 包：

npm init -y

• 安裝依賴項：

npm install

• 構建項目：

npm run build

待辦事項列表

已完成

• [x] 實現基本的短信發送功能
• [x] 添加文本轉語音呼叫支持
• [x] 集成速率限制功能
• [x] 完成輸入驗證邏輯
• [x] 實現詳細的錯誤處理

未完成

• [ ] 添加日誌記錄功能
• [ ] 支持多語言輸出
• [ ] 實現高級的安全措施
• [ ] 添加自動化測試

📄 許可證

本項目採用 MIT 許可證。

貢獻指南

歡迎大家為項目貢獻代碼！請隨時提交 Pull Request。