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