🚀 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。