Clicksend MCP Server

🚀 ClickSend MCP 服務器

ClickSend MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，藉助 ClickSend 的 API 實現了 SMS 消息發送和文本轉語音（TTS）呼叫功能。該服務器讓 AI 模型能夠以編程方式發送 SMS 消息和發起語音電話，為信息傳遞提供了便捷的解決方案。

🚀 快速開始

ClickSend MCP 服務器可幫助 AI 模型實現 SMS 消息發送和語音電話發起功能。以下將為你介紹如何安裝和使用該服務器。

✨ 主要特性

• 短信功能：可向全球任何電話號碼發送 SMS 消息。
• 文本轉語音呼叫：能使用可自定義的文本轉語音消息發起語音電話。
• 速率限制：內置保護機制，每分鐘限 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。