remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides sending SMS messages and making Text-to-Speech calls via ClickSend's API, with features for phone number validation and rate limiting.

ClickSend MCP 服务器

模型上下文协议 (MCP) 服务器，通过 ClickSend 的 API 提供短信和文本转语音 (TTS) 通话功能。该服务器使 AI 模型能够以编程方式发送短信和发起语音通话。

特征

短信：向全球任何电话号码发送短信
文本转语音通话：使用可自定义的文本转语音消息进行语音通话
速率限制：内置保护，每分钟限制 5 次操作
输入验证：对电话号码和消息内容进行全面验证
错误处理：详细的错误消息和正确的错误传播

安装

先决条件

Node.js（v16 或更高版本）
具有 API 凭证的 ClickSend 帐户
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. 发送短信

向指定电话号码发送短信。

参数：

to ：E.164 格式的电话号码（例如 +61423456789）
message ：要发送的文本内容

例子：

{
  "name": "send_sms",
  "arguments": {
    "to": "+61423456789",
    "message": "Hello from ClickSend MCP!"
  }
}

2. make_tts_call

发起文本转语音呼叫。

参数：

to ：E.164 格式的电话号码
message ：要转换为语音的文本内容
voice ：语音类型（“女声”或“男声”，默认为“女声”）

例子：

{
  "name": "make_tts_call",
  "arguments": {
    "to": "+61423456789",
    "message": "This is a Text-to-Speech call from ClickSend MCP",
    "voice": "female"
  }
}

速率限制

为防止滥用，服务器实施了每分钟 5 次操作的速率限制。超过此限制的请求将收到错误响应，并附带重试延迟建议。

发展

可用脚本

npm run build ：编译 TypeScript 并使输出可执行
npm run start ：启动 MCP 服务器
npm run dev ：在监视模式下运行 TypeScript 编译器

项目结构

clicksend-mcp/
├── src/
│   ├── index.ts        # Main server implementation
│   ├── client.ts       # ClickSend API client
│   └── utils/
│       └── validation.ts # Input validation utilities
├── build/              # Compiled JavaScript output
└── package.json        # Project configuration

错误处理

服务器针对各种场景提供了详细的错误消息：

无效的电话号码
消息内容验证失败
超出速率限制
API 身份验证错误
网络连接问题

错误响应包括适当的错误代码和描述性消息，以帮助诊断问题。

待办事项

[ ] 多个收件人
[ ] 配置发件人 ID
[x] 短信
[x] 语音合成
[ ] 电子邮件
[ ] 媒体上传
- [ ] 电子邮件附件
- [ ] 彩信
- [ ] 字母
- [ ] 明信片
- [ ] 传真
[ ] 成本计算与确认
[ ] 统计数据
[ ] 历史
[ ] 联系方式
[ ] 自动化

执照

麻省理工学院

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

该服务器使 AI 模型能够使用具有内置速率限制和输入验证的 ClickSend API 以编程方式发送短信并发起文本转语音呼叫。

Related Resources

Reddit Discussion about this server

ClickSend MCP Server