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. 克隆仓库：

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

1. 安装依赖项：

npm install

1. 构建项目：

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。