ClickSend MCP 服务器

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

特征

• 短信：向全球任何电话号码发送短信

• 文本转语音通话：使用可自定义的文本转语音消息进行语音通话

• 速率限制：内置保护，每分钟限制 5 次操作

• 输入验证：对电话号码和消息内容进行全面验证

• 错误处理：详细的错误消息和正确的错误传播

Related MCP server: Slack MCP Server

安装

先决条件

• 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. 发送短信

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

参数：

• 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 请求。