ClickSend MCP Server

ClickSend MCP Server

site icon
2025.01.30 1
JavaScript短信服务语音服务交流协作
ClickSend MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,通过 ClickSend 的 API 提供 SMS 短信和文本转语音 (TTS) 呼叫功能。该服务使 AI 模型能够以编程方式发送 SMS 消息和发起语音呼叫。
View on GitHub

Overview

基本能力

产品定位

ClickSend MCP Server 是一个通信服务,专注于提供 SMS 短信和文本转语音 (TTS) 呼叫功能。

核心功能

  • SMS 短信发送:向全球任何电话号码发送短信
  • 文本转语音呼叫:使用可自定义的文本转语音消息发起语音呼叫
  • 速率限制:内置保护机制,每分钟限制 5 次操作
  • 输入验证:对电话号码和消息内容进行全面验证
  • 错误处理:提供详细的错误消息和适当的错误传播

适用场景

  • 自动化短信通知系统
  • 语音呼叫提醒服务
  • AI 驱动的通信解决方案

工具列表

  1. send_sms:向指定电话号码发送短信
  2. 参数:to(E.164 格式的电话号码),message(要发送的文本内容)
  3. make_tts_call:发起文本转语音呼叫
  4. 参数:to(E.164 格式的电话号码),message(要转换为语音的文本内容),voice(语音类型,默认为 'female')

常见问题解答

  • 速率限制:服务器实施每分钟 5 次操作的速率限制,超过此限制的请求将收到错误响应
  • 错误处理:服务器提供详细的错误消息,包括无效电话号码、消息内容验证失败、速率限制超过、API 认证错误和网络连接问题等

使用教程

使用依赖

  • Node.js(v16 或更高版本)
  • ClickSend 账户及 API 凭证
  • MCP 兼容客户端

安装教程

  1. 克隆仓库:
git clone https://github.com/J-Gal02/clicksend-mcp.git
cd clicksend-mcp
  1. 安装依赖:
npm install
  1. 构建项目:
npm run build
  1. 设置 MCP 客户端: 在 cline_mcp_settings.jsonclaude_desktop_config.json 文件中添加以下部分,并替换为正确的路径和凭证:
{
    "mcpServers": {
        "clicksend": {
            "command": "node",
            "args": ["/directory/to/build/folder/clicksend-mcp/build/index.js"],
            "env": {
                "CLICKSEND_USERNAME": "[email protected]",
                "CLICKSEND_API_KEY": "ZZZZZZZZ-YYYY-YYYY-YYYY-XXXXXXXXXXXX"
            }
        }
    }
}

调试方式

  • 启动 MCP 服务器:
npm run start
  • 开发模式运行:
npm run dev

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。