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