点击发送-mcp

Name: 点击发送-mcp
Author: J-Gal02

作者：J-Gal023 星标更新：2025-01-30

安装使用来源：spider==github.com

项目介绍

ClickSend MCP Server

一个通过ClickSend API提供短信消息和语音呼叫（TTS）能力的模型上下文协议（MCP）服务器。此服务器使AI模型能够通过编程方式发送短信并发起语音呼叫。

功能

短信消息：向全球任何电话号码发送短信
语音呼叫：使用可定制的文本转语音消息发起语音呼叫
速率限制：内置每分钟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

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

参数：

to：E.164格式的电话号码（例如，+61423456789）
message：要发送的文本内容

示例：

{
  "name": "send_sms",
  "arguments": {
    "to": "+61423456789",
    "message": "来自ClickSend MCP的问候！"
  }
}

2. make_tts_call

发起文本转语音呼叫。

参数：

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

示例：

{
  "name": "make_tts_call",
  "arguments": {
    "to": "+61423456789",
    "message": "这是一条来自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        # 项目配置

错误处理

服务器提供了各种情况下的详细错误信息：

无效的电话号码
消息内容验证失败
超出速率限制
API认证错误
网络连接问题

错误响应包括适当的错误码和描述性消息，以帮助诊断问题。