JinDaGe - ClickSend MCP Server MCP Details

article

README

🚀 ClickSend MCP 服务器

ClickSend MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，借助 ClickSend 的 API，为用户提供 SMS 消息发送和文本转语音（TTS）呼叫功能。它让 AI 模型能够以编程方式轻松实现 SMS 消息发送和语音电话发起。

✨ 主要特性

短信功能：可向全球任意电话号码发送 SMS 消息。
文本转语音呼叫：支持使用可自定义的文本转语音消息发起语音电话。
速率限制：具备内置保护机制，每分钟操作上限为 5 次。
输入验证：对电话号码和消息内容进行全面验证。
错误处理：提供详细的错误信息，并进行适当的错误传播。

📦 安装指南

先决条件

Node.js（版本需为 v16 或更高）
ClickSend 账户及 API 凭证
MCP 兼容客户端

设置

克隆仓库：

git clone https://github.com/J-Gal02/clicksend-mcp.git
cd clicksend-mcp

安装依赖项：

npm install

构建项目：

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。

ClickSend MCP Server