ClickSend MCP Server

🚀 ClickSend MCP 服务器

ClickSend MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，借助 ClickSend 的 API，为用户提供 SMS 消息发送和文本转语音（TTS）呼叫功能。它让 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。