ClickSend MCP Server 使用说明

项目简介

ClickSend MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在通过 ClickSend API 向AI模型提供短信 (SMS) 发送和文本转语音 (TTS) 呼叫能力。该服务器允许AI模型程序化地发送短信和发起语音呼叫，扩展了AI模型的交互能力。

主要功能点

短信发送 (SMS Messaging): 向全球任何电话号码发送短信。
文本转语音呼叫 (Text-to-Speech Calls): 发起带有自定义文本转语音消息的语音呼叫。
速率限制 (Rate Limiting): 内置速率限制保护，每分钟最多执行5个操作，防止滥用。
输入验证 (Input Validation): 对电话号码和消息内容进行全面的格式和有效性验证。
错误处理 (Error Handling): 提供详细的错误消息和适当的错误传播，方便问题诊断。

安装步骤

克隆仓库:

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

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要将 ClickSend MCP 服务器配置到 MCP 客户端（例如 Glama Client 或 Claude 客户端），您需要在客户端的配置文件中添加服务器信息。以下是一个 'cline_mcp_settings.json' 或 'claude_desktop_config.json' 文件的配置示例：

{
    "mcpServers": {
        "clicksend": {
            "command": "node",
            "args": ["/path/to/clicksend-mcp/build/index.js"],
            "env": {
                "CLICKSEND_USERNAME": "YOUR_CLICKSEND_USERNAME",
                "CLICKSEND_API_KEY": "YOUR_CLICKSEND_API_KEY"
            }
        }
    }
}

配置参数说明:

'"clicksend"': 服务器名称，您可以自定义，用于在客户端中标识该服务器。
'"command"': 启动服务器的命令，这里使用 'node' 解释器。
'"args"': 启动命令的参数，指向编译后的服务器入口文件 'build/index.js' 的绝对路径。请务必将 '/path/to/clicksend-mcp' 替换为您的 'clicksend-mcp' 仓库的实际本地路径。
'"env"': 环境变量配置，用于设置 ClickSend API 的用户名和 API 密钥。
- '"CLICKSEND_USERNAME"': 您的 ClickSend 用户名。 请替换为您的实际 ClickSend 用户名。
- '"CLICKSEND_API_KEY"': 您的 ClickSend API 密钥。 请替换为您的实际 ClickSend API 密钥。

重要提示: 您需要在 ClickSend 官网注册账号并获取 API 密钥才能使用此服务器。请将 'YOUR_CLICKSEND_USERNAME' 和 'YOUR_CLICKSEND_API_KEY' 替换为您的真实凭据。

基本使用方法

配置完成后，您的 MCP 客户端应该能够检测到 'clicksend' 服务器。您可以使用以下工具与服务器交互：

1. 'send_sms' (发送短信)

该工具用于发送短信消息。

参数:

'to': 接收方电话号码，必须使用 E.164 格式 (例如: +8613800138000)。
'message': 要发送的短信内容。

示例请求:

{
  "name": "send_sms",
  "arguments": {
    "to": "+8613800138000",
    "message": "你好，这是一条来自 ClickSend MCP 服务器的测试短信！"
  }
}

2. 'make_tts_call' (发起文本转语音呼叫)

该工具用于发起文本转语音呼叫。