金大哥 - ClickSend MCP 详情

article

README

🚀 ClickSend MCP 服务器

ClickSend MCP 服务器是一个借助 ClickSend API 实现短信发送和文本转语音（TTS）呼叫功能的模型上下文协议（MCP）服务器。它让 AI 模型可以通过编程的方式发送 SMS 消息并发起语音通话。

🚀 快速开始

本服务器可助力 AI 模型便捷地实现短信发送与语音呼叫功能，下面为你详细介绍开始使用的步骤。

✨ 主要特性

短信发送：能向全球任何电话号码发送 SMS 消息。
文本转语音呼叫：可使用自定义的 TTS 消息发起语音呼叫。
速率限制：内置保护机制，每分钟最多进行 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": "来自 ClickSend MCP 的问候！"
  }
}

2. make_tts_call

发起文本转语音呼叫。参数：

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

示例：

{
  "name": "make_tts_call",
  "arguments": {
    "to": "+61423456789",
    "message": "这是一个测试消息。",
    "voice": "female"
  }
}

📚 详细文档

脚本命令

初始化 npm 包：

npm init -y

安装依赖项：

npm install

构建项目：

npm run build

🔧 技术细节

待办事项列表

已完成

[x] 实现基本的短信发送功能
[x] 添加文本转语音呼叫支持
[x] 集成速率限制功能
[x] 完成输入验证逻辑
[x] 实现详细的错误处理

未完成

[ ] 添加日志记录功能
[ ] 支持多语言输出
[ ] 实现高级的安全措施
[ ] 添加自动化测试

📄 许可证

MIT

贡献指南

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

ClickSend