# ClickSend消息语音平台
## 基本信息
- Slug: `j-gal02-clicksend-mcp`
- Source: modelscope
- Publisher: @J-Gal02/clicksend-mcp
- Categories: communication / speech-processing
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@J-Gal02/clicksend-mcp
## 简介
该服务器允许人工智能模型通过 ClickSend 的 API 以编程方式发送短信和发起文本转语音电话呼叫，并具有内置的速率限制和输入验证功能。
## 安装提示

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

## MCP Server 详情

# ClickSend MCP 服务器

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

<a href="https://glama.ai/mcp/servers/6nj3h62i6b"><img width="380" height="200" src="https://glama.ai/mcp/servers/6nj3h62i6b/badge" alt="ClickSend Server MCP server" /></a>

## 功能

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

## 安装

### 先决条件

- Node.js（v16 或更高版本）
- 带有 API 凭证的 ClickSend 账户
- 兼容 MCP 的客户端

### 设置

1. 克隆仓库：
```bash
git clone https://github.com/J-Gal02/clicksend-mcp.git
cd clicksend-mcp
```


2. 安装依赖项：
```bash
npm install
```


3. 构建项目：
```bash
npm run build
```


### 设置 MCP 客户端

将以下部分添加到您的 `cline_mcp_settings.json` 文件或 `claude_desktop_config.json` 文件中。

请确保用构建文件夹的正确路径替换目录，如下例所示，并用自己的用户名和 API 密钥替换示例中的相应内容。

```json
{
    "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`：要发送的文本内容

示例：
```json
{
  "name": "send_sms",
  "arguments": {
    "to": "+61423456789",
    "message": "Hello from ClickSend MCP!"
  }
}
```


#### 2. make_tts_call
发起文本转语音通话。

参数：
- `to`：E.164 格式的电话号码
- `message`：要转换为语音的文本内容
- `voice`：声音类型（'female' 或 'male'，默认为 'female'）

示例：
```json
{
  "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] TTS
- [ ] 电子邮件
- [ ] 媒体上传
    - [ ] 电子邮件附件
    - [ ] MMS
    - [ ] 信件
    - [ ] 明信片
    - [ ] 传真
- [ ] 成本计算和确认
- [ ] 统计数据
- [ ] 历史记录
- [ ] 联系人

- [ ] 自动化

## 许可证

[MIT](./LICENSE)

## 贡献

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