短信发送服务

ClickSend MCP Server 是一个为开发者提供的短信发送服务,支持通过API发送短信、计算短信价格、查看短信历史和统计等功能,适用于AI生态系统和平台集成。

  • by ClickSend
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 ClickSend/clicksend-mcp-server

使用说明

单击发送MCP服务器

这是官方 单击发送MCP服务器 由ClickSend团队开发。出于安全原因,请勿使用非官方版本的ClickSend MCP。

目的

ClickSend MCP旨在将ClickSend的消息传递功能扩展到现代人工智能生态系统和平台中 -允许开发人员通过ClickSend轻松发送短信,而无需编写自定义代码。

这加速了采用,实现了新的人工智能驱动用例,并将ClickSend定位为智能自动化时代面向未来的消息传递平台。

需求

  • Node.js>=18
    • 你可以使用nvm (节点版本管理器)设置运行此应用程序的正确版本

安装

下载AI桌面客户端。一个例子是Claude for Desktop,您可以下载 这里.

配置

服务器需要两个环境变量:

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

您可以在以下网址找到用户名和密钥https://dashboard.clicksend.com/account/subaccounts一旦您注册了ClickSend。

Claude桌面配置

  • 打开Claude桌面版

  • 首选 设置 从系统的菜单栏

  • 在设置窗口中,导航到 开发者 选项卡并单击 编辑配置. 这将打开位于以下位置的配置文件:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • 视窗: %APPDATA%\Claude\claude_desktop_config.json

  • 使用NPM包

{
  "mcpServers": {
    "clicksend": {
      "command": "npx",
      "args": [
        "-y",
        "@clicksend/clicksend-mcp-server@latest"
      ],
      "env": { 
        "CLICKSEND_USERNAME": "<username>",
         "CLICKSEND_API_KEY": "<api-key>"
      }
    }
  }
}

  • 使用本地构建
{
  "mcpServers": {
    "clicksend": {
      "command": "node",
      "args": [
        "/path/to/repository/build/clicksend-mcp.js"
      ],
      "env": {
        "CLICKSEND_USERNAME": "your clicksend username",
        "CLICKSEND_API_KEY": "your API Key"
      }
    }
  }
}

之后,重新启动Claude Desktop以重新加载配置。如果已连接,当您单击锤子图标时,您应该看到clicksend send sms。

与Claude的互动示例

以下是通过Claude与服务器交互的一些自然方式:

简单短信:

Send a text message to the number 61411111111 saying "I'm using ClickSend MCP server to sent SMS!"

特性

  • 通过设置clicksend用户名和API密钥,一次发送一条短信
  • 获取向联系人列表发送消息的价格
  • 搜索联系人或联系人列表并向他们发送消息
  • 获取短信模板,并使用该模板发送消息
  • 查看/检索短信历史记录
  • 获取过去30天的短信统计信息

支持的API

  1. POST /v3/sms/send
  • 操作ID: send-sms
  • 摘要: 发送短信
  • 说明: 向收件人发送消息,可以是电话号码或联系人列表中的联系人。
  1. POST /v3/sms/price
  • 操作ID: calculate-sms-price
  • 摘要: 计算短信价格
  • 说明: 根据消息类型和长度计算发送消息的价格。
  1. GET /v3/sms/templates
  • 操作ID: view-sms-templates
  • 摘要: 查看短信模板
  • 说明: 使用筛选选项检索短信模板。
  1. GET /v3/sms/history
  • 操作ID: view-sms-history
  • 摘要: 查看短信历史记录
  • 说明: 查看以前发送的带有过滤和分页选项的短信。
  1. GET /v3/statistics/sms
  • 操作ID: view-sms-statistics
  • 摘要: 查看短信统计信息
  • 说明: 获取过去30天的短信统计数据。
  1. GET /v3/search/contacts-lists
  • 操作ID: view-contact-lists
  • 摘要: 查看联系人列表
  • 说明: 获取搜索到的联系人列表列表。

重要说明

  1. 电话号码格式:所有电话号码必须采用E.164格式(例如+6141111111)
  2. 速率限制:请注意您的ClickSend帐户的费率限制和定价
  3. 安全:确保您的ClickSend凭据安全,永远不要将其提交给版本控制

故障排除

常见错误消息和解决方案:

  1. “电话号码必须采用E.164格式”

    • 确保电话号码以“+”和国家代码开头
  2. “凭据无效”

贡献

欢迎投稿!在提交pull请求之前,请阅读我们的贡献指南。

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

安全

请不要在GitHub issues或pull请求中包含任何敏感信息(如电话号码或ClickSend凭据)。