mcpField
T
TopSMS

TopSMS

本地服务
topsms.cz通信协作04 周前更新
代码仓库访问官网

关于 TopSMS

TopSMS 是通过捷克 TopSMS 商业短信网关发送消息的 MCP 服务，支持定时和批量短信、OTP 验证、送达状态查询，以及账户余额和价格查询。

主要功能

  1. 01发送和定时发送短信
  2. 02向最多 500 个号码批量发送
  3. 03发送并验证 OTP 验证码
  4. 04查询短信和批量任务状态
  5. 05查看余额和价格

适用场景

  1. 01发送预约或服务通知
  2. 02通过 OTP 验证用户手机号
  3. 03跟踪单条或批量短信的送达情况

MCP 相关

向 MCP 客户端提供 TopSMS 消息发送、验证、状态、余额和价格查询工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "topsms-ghb-topsms": {
      "command": "npx",
      "args": [
        "-y",
        "topsms-mcp"
      ],
      "env": {
        "TOPSMS_CLIENT_ID": "<TOPSMS_CLIENT_ID>",
        "TOPSMS_SECRET": "<TOPSMS_SECRET>"
      }
    }
  }
}
启动命令npx -y topsms-mcp
需要配置的环境变量
TOPSMS_CLIENT_IDAPI key Client ID from the TopSMS dashboard (API klíče)
TOPSMS_SECRET密钥API key secret from the TopSMS dashboard

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmtopsms-mcp1.1.0

工具

9

收录的工具列表 · 更新于 2 周前

参数类型必填说明
tostring是国际格式的电话号码，例如 +420601234567（不带前缀的捷克号码也可接受）。
fromstring否已获批准的 Sender ID（最多 11 个字符）。省略时使用默认发送方 "TopSMS"。
textstring是消息文本。
send_atstring否稍后发送的计划时间：带时区的 ISO 8601 格式，例如 2026-10-01T09:00:00+02:00（最多提前 30 天）。省略则立即发送。计划发送会返回 jobId，可用 cancel_scheduled 取消。
idempotencyKeystring否可选的 Idempotency-Key（例如 UUID）。使用相同键重复调用不会重复发送短信；会返回原始响应。

详细介绍

TopSMS MCP 服务

通过 TopSMS 从 Claude、ChatGPT、Cursor 和其他 AI 助手发送短信。TopSMS 是面向企业的捷克短信网关，支持捷克、斯洛伐克和 200 多个国家/地区。

工具

工具功能
send_sms发送一条短信（号码、文本、可选的 Sender ID、可选的 send_at 定时发送时间、可选的幂等键）
send_bulk_sms向最多 500 个号码发送相同文本；收件人超过 50 个时会进入队列，并返回 jobId
get_message_status获取消息的送达状态（已排队、已发送、已送达、失败、已过期）
get_bulk_job查看已排队批量发送任务的进度
cancel_scheduled取消定时发送（返还额度）
verify_send通过短信发送一次性验证码（OTP）
verify_check检查用户输入的验证码
get_credit获取以 CZK 计价的额度余额和每条短信的价格
get_pricing获取公开价格表（无需凭据）

设置

  1. 在 topsms.cz 创建免费账户（赠送 10 条免费短信）。
  2. 在控制面板中打开 API klíče（API 密钥），创建一个具有 send 和 read 权限范围的密钥，然后复制 Client ID 和 Secret。
  3. 将该服务添加到 MCP 客户端。
Claude Desktop / Claude Code
{
  "mcpServers": {
    "topsms": {
      "command": "npx",
      "args": ["-y", "topsms-mcp"],
      "env": {
        "TOPSMS_CLIENT_ID": "your-client-id",
        "TOPSMS_SECRET": "your-secret"
      }
    }
  }
}

Claude Code：claude mcp add topsms -e TOPSMS_CLIENT_ID=... -e TOPSMS_SECRET=... -- npx -y topsms-mcp

Cursor、Windsurf、VS Code

在客户端的 MCP 配置中使用相同的 command、args 和 env。

定价

向捷克和斯洛伐克号码发送短信，每条 0.88–0.98 CZK（≈ €0.036–0.040），无月费，额度永不过期。欧盟地区每段 2 CZK，世界其他地区每段 3 CZK。完整价格表：https://www.topsms.cz/pricing.json

注意事项

  • 每次调用 send_* 都会消耗实际额度。AI 客户端通常会在调用工具前请求确认；请保持启用此功能。
  • 不含变音符号的 160 个字符 = 1 条短信；含变音符号或表情符号时为 70 个字符。
  • API 文档：https://www.topsms.cz/api-integrace/rest-api · 支持：[email protected]

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。