AI导哈

短信息发送

提供全网短信发送的能力

  • 云端部署
  • 更新于

使用说明

顶信 短信服务 MCP 服务器使用指南

欢迎使用 顶信（https://www.dingxin106.com） 短信服务的模型上下文协议（MCP）服务器。本文档将指导您如何连接和使用此服务器，以通过任何兼容 MCP 的 AI 应用（如 AI 编码助手、自动化工作流等）发送短信。

1. 连接信息

您需要将您的 MCP 客户端连接到以下端点：

  • 协议: Streamable HTTP
  • 端点 URL: https://sdkv2.lx598.com/sdk/mcp

2. 认证方式

本服务器的认证是在调用工具时进行的，而不是在建立 MCP 连接时。要成功调用工具，您必须在每次请求的 HTTP 请求头 中提供有效的认证信息：

  • X-MCP-AppID: 您的应用 ID
  • X-MCP-AppSecret: 您的应用密钥

请从您的 顶信 平台管理员处获取这些凭证。

重要: 认证信息不再通过请求体传递，而是必须通过 HTTP 请求头传递。

3. 可用工具

本服务器目前提供以下工具：

com.dlsw.sms/send

功能: 发送单条或批量短信。

参数名 类型 是否必须 描述
content string 是 短信内容。必须包含签名，例如：【您的签名】您的验证码是123456。
aimcodes string 是 目标手机号码，多个号码之间用英文逗号 , 分隔。
schTime string 否 定时发送时间，格式为 yyyy-MM-dd HH:mm:ss。
msgId string 否 由客户端提供的唯一消息 ID，最大长度为20位。
extNo string 否 扩展号码（子号）。

注意: AppID 和 AppSecret 现在通过 HTTP 请求头传递，不再作为参数传递。

4. 使用示例

请求 (Client -> Server)

HTTP 请求头:

X-MCP-AppID: your-app-id
X-MCP-AppSecret: your-app-secret
Content-Type: application/json

请求体:

{
  "method": "tools/call",
  "params": {
    "name": "com.dlsw.sms/send",
    "arguments": {
      "aimcodes": "15002129941",
      "content": "【您的签名】您的验证码是123456"
    },
    "_meta": {
      "progressToken": 0
    }
  }
}

响应 (Server -> Client)

成功响应

{
  "content": [
    {
      "type": "text",
      "text": "{\"replyCode\":1,\"replyMsg\":\"发送成功!\",\"succeedNum\":1,\"failedNum\":0,\"deduction\":\"630\",\"balance\":\"61521976\",\"balanceNum\":939339,\"pkgId\":\"0\",\"billNums\":\"0\",\"chargCount\":9}"
    }
  ]
}

content.text JSON 字段解析:

字段名 类型 说明
replyCode integer 响应码。1 代表成功，其他值为失败。
replyMsg string 响应消息。
succeedNum integer 成功提交的号码数量。
failedNum integer 失败的号码数量。
chargCount integer 计费条数。
deduction integer 本次扣费金额（或条数）。
balance integer 剩余余额。

5. 快速开始

  1. 获取凭证: 从您的 顶信（https://www.dingxin106.com） 管理员处获取 AppID 和 AppSecret。
  2. 配置客户端: 在您的 MCP 客户端（如 Postman, VS Code, Warp 等）中，添加一个新的 MCP 服务器，并将其 URL 设置为 https://sdkv2.lx598.com/sdk/mcp
  3. 设置认证头: 确保在每次请求中都包含 X-MCP-AppID 和 X-MCP-AppSecret 请求头。
  4. 发现工具: 客户端连接后，应能自动发现 com.dlsw.sms/send 工具及其参数。
  5. 调用工具: 构造一个如上所示的 tools/call 请求，注意认证信息在请求头中，业务参数在请求体中。
  6. 处理响应: 解析返回结果中的 content.text JSON 字符串以获取详细的发送状态。

相关 MCP