🚀 ClickSend MCP 服务器

ClickSend MCP 服务器是一个模型上下文协议（MCP）服务器，它允许 Claude 和其他 AI 助手通过 ClickSend 发送短信和彩信，为信息发送提供了便捷的解决方案。

🚀 快速开始

使用此服务器前，需要满足一定的要求并进行相关配置，以下为您详细介绍。

✨ 主要特性

• 只需设置 ClickSend 用户名和 API 密钥，即可一次性发送短信。

📦 安装指南

环境要求

• Node.js >= 18
  • 您可以使用nvm（Node 版本管理器）来设置正确的版本以运行此应用程序。

环境变量配置

该服务器需要两个环境变量：

• CLICKSEND_USERNAME: 您的 ClickSend 用户名
• CLICKSEND_API_KEY: 您的 ClickSend API 密钥

您可以在ClickSend 控制面板找到用户名和密钥，前提是您已注册 ClickSend。

Claude Desktop 配置

要将此服务器与 Claude Desktop 一起使用，请在配置文件中添加以下内容：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "clicksend": {
      "command": "node",
      "args": [
        "-y",
        "@clicksend/sms-mcp-server"
      ],
      "env": {
        "CLICKSEND_USERNAME": "您的ClickSend用户名",
        "CLICKSEND_API_KEY": "您的API密钥",
      }
    }
  }
}

设置完成后，重启 Claude Desktop 以重新加载配置。如果已连接，则在点击锤子图标时应显示“clicksend - send - sms”。

💻 使用示例

基础用法

以下是通过 Claude 与服务器互动的自然方式，以发送简单短信为例：

向号码61411111111发送一条消息：“我正在使用ClickSend MCP服务器发送短信！”

📚 详细文档

重要说明

⚠️ 重要提示

1. 电话号码格式：所有电话号码必须采用 E.164 格式（例如，+61411111111）
2. 速率限制：注意您的 ClickSend 账户的速率限制和定价
3. 安全：保持 ClickSend 凭证的安全性，切勿将其提交到版本控制系统

常见问题

常见错误消息及解决方案：

1. “电话号码必须采用 E.164 格式”
   • 确保电话号码以“+”开头，并包含国家代码。
2. “无效凭证”
   • 检查CLICKSEND_USERNAME和CLICKSEND_API_KEY。您可以在ClickSend 仪表盘复制它们。

贡献

欢迎贡献！请在提交拉取请求之前阅读我们的贡献指南。

安全

⚠️ 重要提示

请勿在 GitHub 问题或拉取请求中包含任何敏感信息（如电话号码或 ClickSend 凭证）。

📄 许可证

本项目根据 MIT 许可证发布，详细信息请参阅 LICENSE 文件。