ClickSend消息语音平台

@J-Gal02/clicksend-mcp

0 Stars 450 次浏览 J-Gal02 更新于 2026-08-23

该服务器允许人工智能模型通过 ClickSend 的 API 以编程方式发送短信和发起文本转语音电话呼叫，并具有内置的速率限制和输入验证功能。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "clicksend": {
      "args": [
        "/directory/to/build/folder/clicksend-mcp/build/index.js"
      ],
      "command": "node",
      "env": {
        "CLICKSEND_API_KEY": "ZZZZZZZZ-YYYY-YYYY-YYYY-XXXXXXXXXXXX",
        "CLICKSEND_USERNAME": "example@droove.net"
      }
    }
  }
}

该服务需要配置环境变量：CLICKSEND_API_KEY、CLICKSEND_USERNAME

可用工具（2 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

send_sms 2 个参数需填 2 项 Send SMS messages via ClickSend

Send SMS messages via ClickSend

必填参数：to、message

make_tts_call 3 个参数需填 2 项 Make Text-to-Speech calls via ClickSend

Make Text-to-Speech calls via ClickSend

必填参数：to、message

服务介绍

ClickSend MCP 服务器

一个通过 ClickSend 的 API 提供短信发送和文本转语音 (TTS) 通话功能的模型上下文协议 (MCP) 服务器。该服务器使 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. send_sms

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

参数：

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：声音类型（'female' 或 'male'，默认为 'female'）

示例：

{
  "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
短信
TTS
电子邮件
媒体上传
- 电子邮件附件
- MMS
- 信件
- 明信片
- 传真
成本计算和确认
统计数据
历史记录
联系人
自动化

许可证

MIT

贡献

欢迎贡献！请随时提交Pull Request。

查看源码项目主页