MCP 服务器

ClickSend MCP Server

这个服务器使 AI 模型能够通过 ClickSend 的 API 以编程方式发送短信和发起文本转语音呼叫，并内置了速率限制和输入验证。

通信

语音处理

JavaScript

访问服务器

Tools

send_sms

Send SMS messages via ClickSend

make_tts_call

Make Text-to-Speech calls via ClickSend

README

ClickSend MCP 服务器

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

功能

SMS 短信: 向全球任何电话号码发送 SMS 消息
文本转语音呼叫: 使用可自定义的文本转语音消息进行语音呼叫
速率限制: 内置保护，限制为每分钟 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

向指定的电话号码发送 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        # 主要服务器实现
│   ├── client.ts       # ClickSend API 客户端
│   └── utils/
│       └── validation.ts # 输入验证实用程序
├── build/              # 编译后的 JavaScript 输出
└── package.json        # 项目配置